bunsane 0.3.2 → 0.4.0

package/studio/dist/assets/index-BpbuYz9g.css

@@ -0,0 +1 @@
+*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}:root{--background: 0 0% 100%;--foreground: 222.2 84% 4.9%;--card: 0 0% 100%;--card-foreground: 222.2 84% 4.9%;--popover: 0 0% 100%;--popover-foreground: 222.2 84% 4.9%;--primary: 24 95% 53%;--primary-foreground: 0 0% 98%;--secondary: 210 40% 96%;--secondary-foreground: 222.2 84% 4.9%;--muted: 210 40% 96%;--muted-foreground: 215.4 16.3% 46.9%;--accent: 210 40% 96%;--accent-foreground: 222.2 84% 4.9%;--destructive: 0 84.2% 60.2%;--destructive-foreground: 210 40% 98%;--border: 214.3 31.8% 91.4%;--input: 214.3 31.8% 91.4%;--ring: 24 95% 53%;--radius: .5rem}*{border-color:hsl(var(--border))}body{background-color:hsl(var(--background));color:hsl(var(--foreground))}.absolute{position:absolute}.relative{position:relative}.left-0{left:0}.left-3{left:.75rem}.top-1\/2{top:50%}.top-full{top:100%}.z-10{z-index:10}.mx-auto{margin-left:auto;margin-right:auto}.mb-1{margin-bottom:.25rem}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-6{margin-bottom:1.5rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-2{margin-left:.5rem}.ml-4{margin-left:1rem}.mr-2{margin-right:.5rem}.mt-0\.5{margin-top:.125rem}.mt-1{margin-top:.25rem}.mt-6{margin-top:1.5rem}.block{display:block}.inline-block{display:inline-block}.flex{display:flex}.inline-flex{display:inline-flex}.table{display:table}.grid{display:grid}.h-10{height:2.5rem}.h-11{height:2.75rem}.h-12{height:3rem}.h-3{height:.75rem}.h-3\.5{height:.875rem}.h-4{height:1rem}.h-40{height:10rem}.h-5{height:1.25rem}.h-9{height:2.25rem}.h-screen{height:100vh}.max-h-96{max-height:24rem}.w-10{width:2.5rem}.w-12{width:3rem}.w-16{width:4rem}.w-3{width:.75rem}.w-3\.5{width:.875rem}.w-4{width:1rem}.w-5{width:1.25rem}.w-80{width:20rem}.w-full{width:100%}.min-w-\[220px\]{min-width:220px}.max-w-2xl{max-width:42rem}.max-w-5xl{max-width:64rem}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-1{flex:1 1 0%}.shrink-0{flex-shrink:0}.-translate-y-1\/2{--tw-translate-y: -50%;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-pointer{cursor:pointer}.select-none{-webkit-user-select:none;-moz-user-select:none;user-select:none}.resize-y{resize:vertical}.grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-start{align-items:flex-start}.items-center{align-items:center}.items-baseline{align-items:baseline}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-1{gap:.25rem}.gap-1\.5{gap:.375rem}.gap-2{gap:.5rem}.gap-3{gap:.75rem}.gap-4{gap:1rem}.gap-6{gap:1.5rem}.space-y-1>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.25rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.25rem * var(--tw-space-y-reverse))}.space-y-2>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.5rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.5rem * var(--tw-space-y-reverse))}.space-y-3>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.75rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.75rem * var(--tw-space-y-reverse))}.space-y-6>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1.5rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1.5rem * var(--tw-space-y-reverse))}.divide-y>:not([hidden])~:not([hidden]){--tw-divide-y-reverse: 0;border-top-width:calc(1px * calc(1 - var(--tw-divide-y-reverse)));border-bottom-width:calc(1px * var(--tw-divide-y-reverse))}.divide-border>:not([hidden])~:not([hidden]){border-color:hsl(var(--border))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-x-auto{overflow-x:auto}.truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.whitespace-nowrap{white-space:nowrap}.whitespace-pre-wrap{white-space:pre-wrap}.break-all{word-break:break-all}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:var(--radius)}.rounded-md{border-radius:calc(var(--radius) - 2px)}.border{border-width:1px}.border-b{border-bottom-width:1px}.border-r{border-right-width:1px}.border-t{border-top-width:1px}.border-dashed{border-style:dashed}.border-border{border-color:hsl(var(--border))}.border-destructive\/20{border-color:hsl(var(--destructive) / .2)}.border-destructive\/30{border-color:hsl(var(--destructive) / .3)}.border-input{border-color:hsl(var(--input))}.border-primary\/30{border-color:hsl(var(--primary) / .3)}.bg-background{background-color:hsl(var(--background))}.bg-card{background-color:hsl(var(--card))}.bg-destructive{background-color:hsl(var(--destructive))}.bg-destructive\/10{background-color:hsl(var(--destructive) / .1)}.bg-destructive\/5{background-color:hsl(var(--destructive) / .05)}.bg-muted{background-color:hsl(var(--muted))}.bg-muted\/50{background-color:hsl(var(--muted) / .5)}.bg-primary{background-color:hsl(var(--primary))}.bg-primary\/10{background-color:hsl(var(--primary) / .1)}.bg-primary\/15{background-color:hsl(var(--primary) / .15)}.bg-secondary{background-color:hsl(var(--secondary))}.p-2{padding:.5rem}.p-3{padding:.75rem}.p-4{padding:1rem}.p-5{padding:1.25rem}.p-6{padding:1.5rem}.p-8{padding:2rem}.px-0{padding-left:0;padding-right:0}.px-2{padding-left:.5rem;padding-right:.5rem}.px-2\.5{padding-left:.625rem;padding-right:.625rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-5{padding-left:1.25rem;padding-right:1.25rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0\.5{padding-top:.125rem;padding-bottom:.125rem}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-4{padding-top:1rem;padding-bottom:1rem}.pl-10{padding-left:2.5rem}.pl-9{padding-left:2.25rem}.text-left{text-align:left}.text-center{text-align:center}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.text-xs{font-size:.75rem;line-height:1rem}.font-bold{font-weight:700}.font-medium{font-weight:500}.font-semibold{font-weight:600}.tabular-nums{--tw-numeric-spacing: tabular-nums;font-variant-numeric:var(--tw-ordinal) var(--tw-slashed-zero) var(--tw-numeric-figure) var(--tw-numeric-spacing) var(--tw-numeric-fraction)}.text-destructive{color:hsl(var(--destructive))}.text-destructive-foreground{color:hsl(var(--destructive-foreground))}.text-foreground{color:hsl(var(--foreground))}.text-muted-foreground{color:hsl(var(--muted-foreground))}.text-primary{color:hsl(var(--primary))}.text-primary-foreground{color:hsl(var(--primary-foreground))}.text-secondary-foreground{color:hsl(var(--secondary-foreground))}.underline-offset-4{text-underline-offset:4px}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.outline{outline-style:solid}.ring-offset-background{--tw-ring-offset-color: hsl(var(--background))}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}@keyframes enter{0%{opacity:var(--tw-enter-opacity, 1);transform:translate3d(var(--tw-enter-translate-x, 0),var(--tw-enter-translate-y, 0),0) scale3d(var(--tw-enter-scale, 1),var(--tw-enter-scale, 1),var(--tw-enter-scale, 1)) rotate(var(--tw-enter-rotate, 0))}}@keyframes exit{to{opacity:var(--tw-exit-opacity, 1);transform:translate3d(var(--tw-exit-translate-x, 0),var(--tw-exit-translate-y, 0),0) scale3d(var(--tw-exit-scale, 1),var(--tw-exit-scale, 1),var(--tw-exit-scale, 1)) rotate(var(--tw-exit-rotate, 0))}}.duration-300{animation-duration:.3s}.file\:border-0::file-selector-button{border-width:0px}.file\:bg-transparent::file-selector-button{background-color:transparent}.file\:text-sm::file-selector-button{font-size:.875rem;line-height:1.25rem}.file\:font-medium::file-selector-button{font-weight:500}.placeholder\:text-muted-foreground::-moz-placeholder{color:hsl(var(--muted-foreground))}.placeholder\:text-muted-foreground::placeholder{color:hsl(var(--muted-foreground))}.first\:rounded-t-md:first-child{border-top-left-radius:calc(var(--radius) - 2px);border-top-right-radius:calc(var(--radius) - 2px)}.last\:rounded-b-md:last-child{border-bottom-right-radius:calc(var(--radius) - 2px);border-bottom-left-radius:calc(var(--radius) - 2px)}.hover\:bg-accent:hover{background-color:hsl(var(--accent))}.hover\:bg-accent\/50:hover{background-color:hsl(var(--accent) / .5)}.hover\:bg-destructive\/90:hover{background-color:hsl(var(--destructive) / .9)}.hover\:bg-muted\/30:hover{background-color:hsl(var(--muted) / .3)}.hover\:bg-muted\/50:hover{background-color:hsl(var(--muted) / .5)}.hover\:bg-primary\/20:hover{background-color:hsl(var(--primary) / .2)}.hover\:bg-primary\/90:hover{background-color:hsl(var(--primary) / .9)}.hover\:bg-secondary\/80:hover{background-color:hsl(var(--secondary) / .8)}.hover\:text-accent-foreground:hover{color:hsl(var(--accent-foreground))}.hover\:text-foreground:hover{color:hsl(var(--foreground))}.hover\:underline:hover{text-decoration-line:underline}.focus\:outline-none:focus{outline:2px solid transparent;outline-offset:2px}.focus\:ring-2:focus{--tw-ring-offset-shadow: var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);--tw-ring-shadow: var(--tw-ring-inset) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color);box-shadow:var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow, 0 0 #0000)}.focus\:ring-primary:focus{--tw-ring-color: hsl(var(--primary))}.focus\:ring-ring:focus{--tw-ring-color: hsl(var(--ring))}.focus\:ring-offset-2:focus{--tw-ring-offset-width: 2px}.focus-visible\:outline-none:focus-visible{outline:2px solid transparent;outline-offset:2px}.focus-visible\:ring-2:focus-visible{--tw-ring-offset-shadow: var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);--tw-ring-shadow: var(--tw-ring-inset) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color);box-shadow:var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow, 0 0 #0000)}.focus-visible\:ring-ring:focus-visible{--tw-ring-color: hsl(var(--ring))}.focus-visible\:ring-offset-2:focus-visible{--tw-ring-offset-width: 2px}.disabled\:pointer-events-none:disabled{pointer-events:none}.disabled\:cursor-not-allowed:disabled{cursor:not-allowed}.disabled\:opacity-50:disabled{opacity:.5}@media (min-width: 768px){.md\:grid-cols-3{grid-template-columns:repeat(3,minmax(0,1fr))}.md\:grid-cols-4{grid-template-columns:repeat(4,minmax(0,1fr))}}@media (min-width: 1024px){.lg\:grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}}

package/studio/{index.html → dist/index.html}

@@ -5,9 +5,10 @@
     <link rel="icon" type="image/svg+xml" href="/studio/favicon.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>BunSane Studio</title>
+    <script type="module" crossorigin src="/studio/assets/index-BMZ67Npg.js"></script>
+    <link rel="stylesheet" crossorigin href="/studio/assets/index-BpbuYz9g.css">
   </head>
   <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
+    <div id="root"></div>
   </body>
 </html>

package/swagger/generator.ts

@@ -25,6 +25,7 @@ export interface OpenAPISpec {
 
 export class OpenAPISpecGenerator {
     private spec: OpenAPISpec;
+    private _jsonCache: string | undefined;
 
     constructor(title: string = "API Documentation", version: string = "1.0.0") {
         this.spec = {
@@ -61,6 +62,7 @@ export class OpenAPISpecGenerator {
                 }
             }
         };
+        this._jsonCache = undefined;
     }
 
     addServer(url: string, description?: string) {
@@ -68,6 +70,7 @@ export class OpenAPISpecGenerator {
             this.spec.servers = [];
         }
         this.spec.servers.push({ url, description });
+        this._jsonCache = undefined;
     }
 
     addSecurityScheme(name: string, scheme: any) {
@@ -78,6 +81,7 @@ export class OpenAPISpecGenerator {
             this.spec.components.securitySchemes = {};
         }
         this.spec.components.securitySchemes[name] = scheme;
+        this._jsonCache = undefined;
     }
 
     addSchema(name: string, schema: any) {
@@ -88,13 +92,19 @@ export class OpenAPISpecGenerator {
             this.spec.components.schemas = {};
         }
         this.spec.components.schemas[name] = schema;
+        this._jsonCache = undefined;
     }
 
     generate(): OpenAPISpec {
         return this.spec;
     }
 
+    // Memoized — spec is frozen after startup so re-serialization per request
+    // is unnecessary. Mutator methods above clear the cache on any post-boot change.
     toJSON(): string {
-        return JSON.stringify(this.spec, null, 2);
+        if (!this._jsonCache) {
+            this._jsonCache = JSON.stringify(this.spec, null, 2);
+        }
+        return this._jsonCache;
     }
 }

package/upload/UploadManager.ts

@@ -21,7 +21,7 @@ export class UploadManager {
     private constructor() {
         this.fileValidator = new FileValidator();
         this.globalConfig = this.getDefaultConfiguration();
-        this.initializeDefaultProviders();
+        this.registerDefaultProviders();
     }
 
     public static getInstance(): UploadManager {
@@ -185,11 +185,13 @@ export class UploadManager {
         return { ...this.globalConfig };
     }
 
-    private async initializeDefaultProviders(): Promise<void> {
-        // Register default local storage provider
-        const localProvider = new LocalStorageProvider();
-        await localProvider.initialize();
-        this.registerStorageProvider("local", localProvider);
+    private registerDefaultProviders(): void {
+        // Synchronous registration. Must NOT be async/awaited: any await here
+        // would defer registration to a later microtask, after which a caller's
+        // post-construction `registerStorageProvider("local", custom)` would be
+        // silently clobbered by the default. See BUNSANE-007.
+        // LocalStorageProvider creates its base directory in its constructor.
+        this.registerStorageProvider("local", new LocalStorageProvider());
     }
 
     private getDefaultConfiguration(): UploadConfiguration {

package/utils/uuid.ts

@@ -1,10 +1,40 @@
-export const uuidv7 = () => {
-  return 'tttttttt-tttt-7xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
-    const r = Math.trunc(Math.random() * 16);
-    const v = c == 'x' ? r : (r & 0x3 | 0x8);
-    return v.toString(16);
-  }).replace(/^[t]{8}-[t]{4}/, function() {
-    const unixtimestamp = Date.now().toString(16).padStart(12, '0');
-    return unixtimestamp.slice(0, 8) + '-' + unixtimestamp.slice(8);
-  });
-}
+// RFC 9562 UUIDv7: 48-bit unix-ms timestamp | ver 7 | 12-bit monotonic
+// sub-millisecond sequence (rand_a) | variant | 62 random bits (rand_b).
+//
+// The previous implementation used Math.random() with no sequence — two ids
+// generated in the same millisecond could collide and were not monotonic
+// (breaks index locality and the "sortable id" assumption at high insert
+// rates). This one keeps strict per-process monotonicity: same-ms calls bump
+// the 12-bit sequence; on overflow we borrow the next millisecond.
+
+let lastTs = -1;
+let seq = 0;
+
+const HEX: string[] = new Array(256);
+for (let i = 0; i < 256; i++) HEX[i] = i.toString(16).padStart(2, '0');
+
+// Reused buffer — uuidv7 is called once per entity + once per component on
+// every insert; per-call allocation matters. Single-threaded JS makes the
+// shared buffer safe.
+const rnd = new Uint8Array(8);
+
+export const uuidv7 = (): string => {
+  let ts = Date.now();
+  if (ts <= lastTs) {
+    seq = (seq + 1) & 0xfff;
+    if (seq === 0) lastTs++;
+    ts = lastTs;
+  } else {
+    lastTs = ts;
+    seq = 0;
+  }
+
+  const tsHex = ts.toString(16).padStart(12, '0');
+  crypto.getRandomValues(rnd);
+  rnd[0] = (rnd[0]! & 0x3f) | 0x80; // variant bits 10xx
+
+  let randHex = '';
+  for (let i = 0; i < 8; i++) randHex += HEX[rnd[i]!];
+
+  return `${tsHex.slice(0, 8)}-${tsHex.slice(8)}-7${seq.toString(16).padStart(3, '0')}-${randHex.slice(0, 4)}-${randHex.slice(4)}`;
+};

package/.claude/scheduled_tasks.lock

@@ -1 +0,0 @@
-{"sessionId":"302022ef-825d-48c8-8ef6-656f1cd141e0","pid":60520,"procStart":"639139204827053470","acquiredAt":1778489386099}

package/.claude/settings.local.json

@@ -1,47 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(bun test:*)",
-      "mcp__serena__check_onboarding_performed",
-      "mcp__serena__activate_project",
-      "mcp__serena__onboarding",
-      "mcp__serena__list_dir",
-      "mcp__serena__find_file",
-      "mcp__serena__get_symbols_overview",
-      "mcp__serena__find_symbol",
-      "mcp__serena__think_about_collected_information",
-      "mcp__serena__write_memory",
-      "mcp__serena__list_memories",
-      "Bash(grep:*)",
-      "mcp__serena__initial_instructions",
-      "mcp__serena__read_memory",
-      "mcp__serena__search_for_pattern",
-      "mcp__serena__think_about_whether_you_are_done",
-      "mcp__serena__replace_symbol_body",
-      "Bash(find:*)",
-      "mcp__serena__get_current_config",
-      "mcp__serena__think_about_task_adherence",
-      "Bash(bun run tsc:*)",
-      "mcp__serena__insert_after_symbol",
-      "Bash(npx tsc:*)",
-      "Bash(STRESS_RECORD_COUNT=10000 bun test:*)",
-      "Bash(STRESS_RECORD_COUNT=1000 bun test:*)",
-      "mcp__serena__find_referencing_symbols",
-      "Bash(bun tsc:*)",
-      "mcp__serena__edit_memory",
-      "Bash(bunx tsc:*)",
-      "Bash(wc:*)",
-      "Bash(bun run:*)",
-      "Bash(BUN_CONFIG_FILE=/dev/null bun test:*)",
-      "Bash(echo:*)",
-      "WebSearch",
-      "Bash(bun:*)",
-      "Bash(tsc:*)",
-      "Bash(SKIP_TEST_DB_SETUP=true bun test:*)"
-    ]
-  },
-  "statusLine": {
-    "type": "command",
-    "command": "input=$(cat); model=$(echo \"$input\" | jq -r '.model.display_name'); used=$(echo \"$input\" | jq -r '.context_window.used_percentage // empty'); remaining=$(echo \"$input\" | jq -r '.context_window.remaining_percentage // empty'); if [ -n \"$remaining\" ]; then printf \"%s | Context: %.1f%% used, %.1f%% remaining\" \"$model\" \"$used\" \"$remaining\"; else echo \"$model\"; fi"
-  }
-}

package/.prettierrc

@@ -1,4 +0,0 @@
-{
-  "tabWidth": 4,
-  "useTabs": false
-}

package/.serena/memories/architectural-decision-no-dependency-injection.md

@@ -1,76 +0,0 @@
-# Architectural Decision: No Dependency Injection (For Now)
-
-**Date:** 2026-01-21  
-**Status:** Decided  
-**Context:** Framework v0.1.5 (experimental)
-
-## Decision
-
-BunSane will NOT implement a formal Dependency Injection (DI) container at this stage.
-
-## Current Approach
-
-The framework uses:
-- **Singleton patterns** for shared services (`CacheManager.getInstance()`, `EntityManager.instance`, `ComponentRegistry`)
-- **Global exports** for database (`import db from "database"`) and logger
-- **ApplicationLifecycle phases** for managing initialization order
-- **Metadata-driven decorators** for component/service registration
-
-## Rationale
-
-### Why DI Was Considered
-- Testing pain points: type-unsafe hacks like `(EntityManager as any).dbReady = true`
-- Hard to mock/swap implementations in tests
-- Singletons share global state between tests
-
-### Why DI Was Rejected (For Now)
-
-1. **Framework is experimental (v0.1.5)** - Too early for such fundamental architectural changes
-
-2. **Added complexity outweighs benefits** - DI adds another abstraction layer to an already complex ECS + GraphQL framework
-
-3. **Current approach works** - ApplicationLifecycle phases already manage dependency initialization order effectively
-
-4. **Users don't need to swap implementations** - Extensions happen via Components, Services, and Plugins, none of which benefit significantly from DI
-
-5. **Testing pain can be solved simpler** - Lightweight patterns like `reset()` methods or optional instance injection suffice
-
-6. **Bun ecosystem norms** - DI isn't a common pattern in modern Bun/TypeScript frameworks
-
-7. **Runtime overhead** - Relevant concern for a performance-focused framework
-
-## Alternative: Lightweight Testability Pattern
-
-Instead of full DI, use optional instance injection for testability:
-
-```typescript
-class CacheManager {
-    private static _instance: CacheManager | null = null;
-    
-    static getInstance(): CacheManager {
-        return this._instance ??= new CacheManager();
-    }
-    
-    // For testing only
-    static setInstance(instance: CacheManager | null): void {
-        this._instance = instance;
-    }
-}
-```
-
-## When to Revisit
-
-Consider DI if/when:
-- Framework reaches v1.0 with stable APIs
-- Users request ability to swap implementations
-- Codebase grows significantly larger (200+ files)
-- Multiple database/cache backends become first-class options
-
-## Related Files
-
-- `core/cache/CacheManager.ts` - Singleton cache manager
-- `core/EntityManager.ts` - Singleton entity manager
-- `core/components/ComponentRegistry.ts` - Singleton component registry
-- `service/ServiceRegistry.ts` - Singleton service registry
-- `core/ApplicationLifecycle.ts` - Lifecycle phase management
-- `database/index.ts` - Global database export

package/.serena/memories/architecture.md

@@ -1,154 +0,0 @@
-# Project Architecture
-
-## Directory Structure
-
-```
-bunsane/
-├── core/                    # Core framework
-│   ├── App.ts              # Main application entry point
-│   ├── Entity.ts           # Entity class (base data unit)
-│   ├── EntityManager.ts    # Entity lifecycle management
-│   ├── ArcheType.ts        # Entity templates with component definitions
-│   ├── BatchLoader.ts      # DataLoader for batching DB queries
-│   ├── Config.ts           # Configuration management
-│   ├── Logger.ts           # Pino logging setup
-│   ├── ErrorHandler.ts     # Error handling utilities
-│   ├── RequestContext.ts   # Request-scoped context
-│   ├── ApplicationLifecycle.ts  # App state management
-│   ├── cache/              # Caching system
-│   │   ├── CacheManager.ts     # Main cache orchestration
-│   │   ├── CacheProvider.ts    # Standard interface (all providers implement this)
-│   │   ├── MemoryCache.ts      # In-memory cache provider
-│   │   ├── RedisCache.ts       # Redis cache provider
-│   │   ├── MultiLevelCache.ts  # L1/L2 cache strategy (wrapper)
-│   │   ├── CacheAnalytics.ts   # Analytics wrapper provider
-│   │   ├── TTLStrategy.ts      # Adaptive TTL wrapper provider
-│   │   └── ...
-│   ├── components/         # Component system
-│   │   ├── BaseComponent.ts    # Base class for components
-│   │   ├── ComponentRegistry.ts # Component registration
-│   │   ├── Decorators.ts       # @Component, @CompData decorators
-│   │   └── ...
-│   ├── decorators/         # Additional decorators
-│   ├── events/             # Event system
-│   └── metadata/           # Metadata utilities
-├── database/               # Database layer
-│   ├── index.ts            # PostgreSQL connection (postgres.js)
-│   ├── DatabaseHelper.ts   # DB setup and migrations
-│   ├── PreparedStatementCache.ts  # Query caching
-│   └── IndexingStrategy.ts # Index management
-├── query/                  # Query builder
-│   ├── Query.ts            # Main query class
-│   ├── FilterBuilder.ts    # Filter construction
-│   ├── QueryDAG.ts         # Query execution graph
-│   └── ...
-├── gql/                    # GraphQL generation
-│   ├── Generator.ts        # Schema generation
-│   ├── builders/           # Type/resolver builders
-│   ├── decorators/         # GQL decorators
-│   ├── strategies/         # Type generation strategies
-│   └── visitors/           # Schema visitors
-├── service/                # Service layer
-│   ├── Service.ts          # Base service class
-│   └── ServiceRegistry.ts  # Service registration
-├── plugins/                # Plugin system
-├── scheduler/              # Task scheduling
-├── storage/                # File storage
-├── upload/                 # File upload handling
-├── rest/                   # REST endpoint support
-├── swagger/                # OpenAPI documentation
-├── studio/                 # BunSane Studio (web UI)
-├── test/                   # Tests
-│   ├── setup.ts            # Test environment setup
-│   ├── integration/        # Integration tests
-│   └── gql/                # GraphQL tests
-├── types/                  # Type definitions
-└── utils/                  # Utility functions
-```
-
-## Core Concepts Flow
-
-1. **App** initializes the application, sets up GraphQL Yoga server
-2. **Components** are registered via `@Component` decorator
-3. **Entities** are created and manipulated, storing component data
-4. **ArcheTypes** define entity templates for type-safe component access
-5. **Query** builder retrieves entities with filters and component population
-6. **Services** define business logic and auto-generate GraphQL resolvers
-7. **CacheManager** handles caching at entity/component/query levels
-
-## Cache System Architecture
-
-All cache providers implement the standardized `CacheProvider` interface:
-
-```typescript
-interface CacheProvider {
-    get<T>(key: string): Promise<T | null>;
-    set<T>(key: string, value: T, ttl?: number): Promise<void>;
-    delete(key: string | string[]): Promise<void>;  // Supports single or multiple
-    clear(): Promise<void>;
-    getMany<T>(keys: string[]): Promise<(T | null)[]>;  // Returns ordered array
-    setMany<T>(entries: Array<{key, value, ttl?}>): Promise<void>;  // Per-entry TTL
-    deleteMany(keys: string[]): Promise<void>;
-    invalidatePattern(pattern: string): Promise<void>;
-    ping(): Promise<boolean>;  // Health check
-    getStats(): Promise<CacheStats>;  // Metrics
-}
-```
-
-**Cache Providers**:
-- **MemoryCache**: In-memory LRU cache (base implementation)
-- **RedisCache**: Redis-backed cache (base implementation)
-- **MultiLevelCacheProvider**: L1 (memory) + L2 (Redis) wrapper
-- **AnalyticsCacheProvider**: Metrics and latency tracking wrapper
-- **AdaptiveTTLProvider**: Dynamic TTL adjustment wrapper
-
-**Key Design Decisions** (as of 2026-01-24):
-- Batch operations use arrays instead of Maps for ordering and flexibility
-- `delete()` accepts both single string and string array for convenience
-- `ping()` replaces `healthCheck()` for conventional naming
-- All wrappers maintain full interface compliance
-
-## Import Resolution (as of 2026-02-05)
-
-All internal imports use **relative paths** (`./`, `../`). Bare imports like `from "core/Logger"` that rely on `baseUrl` are NOT allowed because they break TypeScript type checking for consumers who install bunsane as a dependency (their tsconfig does not have baseUrl pointing to bunsane root).
-
-## Data Model
-
-- **Entity**: UUID-identified record in `entities` table
-- **Component**: JSONB data in `components` table, linked to entity
-- Components are identified by `entity_id` + `component_type`
-- Supports indexing specific component fields for queries
-
-## CORS System (as of 2026-02-04)
-
-The App class (`core/App.ts`) provides comprehensive CORS support with proper spec compliance.
-
-**CorsConfig Type**:
-```typescript
-type CorsConfig = {
-    origin?: string | string[] | ((origin: string) => boolean);
-    credentials?: boolean;
-    allowedHeaders?: string[];
-    exposedHeaders?: string[];  // For Access-Control-Expose-Headers
-    methods?: string[];
-    maxAge?: number;  // Preflight cache duration in seconds
-};
-```
-
-**Key Features**:
-- **Origin Validation**: Validates request Origin header against configured origins
-- **Array Origins**: Returns the matching origin (not comma-joined) per spec
-- **Function Origins**: Supports `(origin: string) => boolean` for dynamic validation
-- **Credentials + Wildcard**: When credentials=true with origin="*", reflects actual origin instead of wildcard
-- **Vary Header**: Always includes `Vary: Origin` for proper caching
-- **All Endpoints**: CORS headers applied to all response paths (health, docs, openapi, studio, errors)
-
-**Usage**:
-```typescript
-app.setCors({
-    origin: ["http://localhost:3000", "https://myapp.com"],
-    credentials: true,
-    maxAge: 86400,
-    exposedHeaders: ["X-Custom-Header"]
-});
-```

package/.serena/memories/cache-interface-refactoring-2026-01-24.md

@@ -1,165 +0,0 @@
-# Cache Interface Refactoring - January 24, 2026
-
-## Status: COMPLETED
-**Completion Date**: 2026-01-24
-**Outcome**: Successfully standardized CacheProvider interface implementation across all cache-related files
-
-## Summary
-Fixed TypeScript compilation errors caused by mismatches between the `CacheProvider` interface and its implementations. The interface was correct, but several wrapper classes and test files had outdated method signatures.
-
-## Impact
-- **Errors Reduced**: From 100+ TypeScript errors to 69
-- **Cache Errors**: Fully resolved (0 remaining)
-- **Remaining Errors**: Unrelated to cache (SchedulerManager, GraphQL builders, test access to private members)
-
-## Files Modified
-
-### Core Cache Files (3 files)
-
-#### 1. `core/cache/CacheAnalytics.ts`
-**Class**: `AnalyticsCacheProvider`
-
-Changes:
-- Changed import to type-only import: `import type { CacheProvider } from './CacheProvider'`
-- Made `recordLatency` method public
-- Fixed method signatures:
-  - `delete(key: string | string[]): Promise<void>` (was single key only)
-  - `getMany<T>(keys: string[]): Promise<(T | null)[]>` (was returning Map)
-  - `setMany<T>(entries: Array<{key, value, ttl?}>): Promise<void>` (was using Map)
-  - `deleteMany(keys: string[]): Promise<void>` (added proper typing)
-  - `ping(): Promise<boolean>` (replaced `healthCheck()`)
-  - `getStats(): Promise<CacheStats>` (was async but not typed correctly)
-- Removed `has()` method (not in interface)
-
-#### 2. `core/cache/MultiLevelCache.ts`
-**Class**: `MultiLevelCacheProvider`
-
-Changes:
-- Fixed import path and made type-only
-- Applied same method signature fixes as CacheAnalytics
-- Added proper type guards for array access in `delete()` method
-- Ensured L1/L2 cache coordination respects new interface
-
-#### 3. `core/cache/TTLStrategy.ts`
-**Class**: `AdaptiveTTLProvider`
-
-Changes:
-- Applied same method signature fixes as above
-- Ensured TTL adaptation logic works with updated interface
-
-### Config Files (1 file)
-
-#### 4. `config/cache.config.ts`
-
-Changes:
-- Added `'multilevel'` to provider type union
-- Added `query` property with structure:
-  ```typescript
-  query: {
-    enabled: boolean;
-    ttl: number;
-    maxSize: number;
-  }
-  ```
-
-### Test Files (7 files)
-
-#### 5. `tests/unit/cache/MemoryCache.test.ts`
-- Added explicit type parameters to `cache.get<T>()` calls
-- Ensures type safety in test assertions
-
-#### 6. `tests/unit/cache/RedisCache.test.ts`
-- Added explicit type parameters to `cache.get<T>()` calls
-
-#### 7-11. Test Configuration Files
-Added `maxSize` to query config objects in:
-- `tests/integration/cache/CacheInvalidation.test.ts`
-- `tests/setup.ts`
-- `tests/stress/cursor-perf-test.ts`
-- `tests/unit/cache/CacheManager.test.ts`
-- `tests/utils/test-context.ts`
-
-## Key Interface Contract
-
-```typescript
-interface CacheProvider {
-    // Single operations
-    get<T>(key: string): Promise<T | null>;
-    set<T>(key: string, value: T, ttl?: number): Promise<void>;
-    delete(key: string | string[]): Promise<void>;
-    clear(): Promise<void>;
-    
-    // Batch operations
-    getMany<T>(keys: string[]): Promise<(T | null)[]>;
-    setMany<T>(entries: Array<{key: string, value: T, ttl?: number}>): Promise<void>;
-    deleteMany(keys: string[]): Promise<void>;
-    
-    // Pattern operations
-    invalidatePattern(pattern: string): Promise<void>;
-    
-    // Health and metrics
-    ping(): Promise<boolean>;
-    getStats(): Promise<CacheStats>;
-}
-```
-
-## Critical Design Decisions
-
-### 1. Array Return for getMany
-**Decision**: `getMany` returns `Promise<(T | null)[]>` instead of `Map<string, T | null>`
-**Rationale**: 
-- Maintains order of requested keys
-- Simpler type handling
-- Better performance for indexed access
-
-### 2. Entry Array for setMany
-**Decision**: `setMany` takes `Array<{key, value, ttl?}>` instead of `Map`
-**Rationale**:
-- Supports per-entry TTL configuration
-- More flexible than Map-based approach
-- Aligns with common cache API patterns
-
-### 3. Flexible Delete
-**Decision**: `delete(key: string | string[])` accepts both single and multiple keys
-**Rationale**:
-- Reduces API surface area (no need for separate deleteOne/deleteMany)
-- Convenience for common use cases
-- Backward compatible with single-key usage
-
-### 4. Ping Instead of HealthCheck
-**Decision**: Renamed `healthCheck()` to `ping()`
-**Rationale**:
-- Shorter, more conventional name
-- Matches Redis and memcached naming
-- Clearer intent (simple connectivity check)
-
-## Verification
-
-### TypeScript Compilation
-- All cache-related files now compile without errors
-- Type safety enforced across all implementations
-- No type assertions or `any` types introduced
-
-### Interface Compliance
-All three wrapper implementations now fully comply:
-- AnalyticsCacheProvider (wraps any provider with metrics)
-- MultiLevelCacheProvider (L1/L2 cache coordination)
-- AdaptiveTTLProvider (dynamic TTL adjustment)
-
-## Follow-Up Items
-
-None for cache. Remaining TypeScript errors are in:
-1. **SchedulerManager**: Unrelated to cache
-2. **GraphQL builders**: Schema generation issues
-3. **Test files**: Access to private members (test-specific issues)
-
-## Lessons Learned
-
-1. **Interface-First Design**: Having a well-defined interface is only half the battle; keeping implementations in sync is critical
-2. **Type-Only Imports**: Using `import type` helps clarify when you're only referencing types vs. runtime values
-3. **Batch Operations**: The switch from Map to Array for batch ops required careful consideration of ordering and flexibility
-4. **Test Coverage**: Tests that use explicit type parameters catch more type mismatches earlier
-
-## Related Memories
-- See `architecture` for overall cache system design
-- See `code_style_and_conventions` for TypeScript patterns used