alepha 0.18.2 → 0.18.3

package/src/system/index.browser.ts

@@ -10,6 +10,7 @@ export * from "./providers/FileSystemProvider.ts";
 export * from "./providers/MemoryFileSystemProvider.ts";
 export * from "./providers/MemoryShellProvider.ts";
 export * from "./providers/ShellProvider.ts";
+export * from "./providers/WorkerdFileSystemProvider.ts";
 export * from "./services/FileDetector.ts";
 
 export const AlephaSystem = $module({

package/src/system/index.ts

@@ -5,6 +5,7 @@ import { MemoryShellProvider } from "./providers/MemoryShellProvider.ts";
 import { NodeFileSystemProvider } from "./providers/NodeFileSystemProvider.ts";
 import { NodeShellProvider } from "./providers/NodeShellProvider.ts";
 import { ShellProvider } from "./providers/ShellProvider.ts";
+import { WorkerdFileSystemProvider } from "./providers/WorkerdFileSystemProvider.ts";
 import { FileDetector } from "./services/FileDetector.ts";
 
 // ---------------------------------------------------------------------------------------------------------------------
@@ -16,6 +17,7 @@ export * from "./providers/MemoryShellProvider.ts";
 export * from "./providers/NodeFileSystemProvider.ts";
 export * from "./providers/NodeShellProvider.ts";
 export * from "./providers/ShellProvider.ts";
+export * from "./providers/WorkerdFileSystemProvider.ts";
 export * from "./services/FileDetector.ts";
 
 // ---------------------------------------------------------------------------------------------------------------------
@@ -39,6 +41,7 @@ export const AlephaSystem = $module({
     FileSystemProvider,
     MemoryFileSystemProvider,
     NodeFileSystemProvider,
+    WorkerdFileSystemProvider,
     ShellProvider,
     MemoryShellProvider,
     NodeShellProvider,

package/src/system/index.workerd.ts

@@ -1 +1,39 @@
-export * from "./index.browser.ts";
+import { $module } from "alepha";
+import { FileSystemProvider } from "./providers/FileSystemProvider.ts";
+import { MemoryFileSystemProvider } from "./providers/MemoryFileSystemProvider.ts";
+import { MemoryShellProvider } from "./providers/MemoryShellProvider.ts";
+import { ShellProvider } from "./providers/ShellProvider.ts";
+import { WorkerdFileSystemProvider } from "./providers/WorkerdFileSystemProvider.ts";
+import { FileDetector } from "./services/FileDetector.ts";
+
+export * from "./errors/FileError.ts";
+export * from "./providers/FileSystemProvider.ts";
+export * from "./providers/MemoryFileSystemProvider.ts";
+export * from "./providers/MemoryShellProvider.ts";
+export * from "./providers/ShellProvider.ts";
+export * from "./providers/WorkerdFileSystemProvider.ts";
+export * from "./services/FileDetector.ts";
+
+export const AlephaSystem = $module({
+  name: "alepha.system",
+  services: [
+    FileDetector,
+    FileSystemProvider,
+    MemoryFileSystemProvider,
+    WorkerdFileSystemProvider,
+    ShellProvider,
+    MemoryShellProvider,
+  ],
+  register: (alepha) =>
+    alepha
+      .with({
+        optional: true,
+        provide: FileSystemProvider,
+        use: WorkerdFileSystemProvider,
+      })
+      .with({
+        optional: true,
+        provide: ShellProvider,
+        use: MemoryShellProvider,
+      }),
+});

package/src/system/providers/WorkerdFileSystemProvider.ts

@@ -0,0 +1,365 @@
+import { $inject, AlephaError, type FileLike, Json } from "alepha";
+import { FileDetector } from "../services/FileDetector.ts";
+import type {
+  CpOptions,
+  CreateFileOptions,
+  FileSystemProvider,
+  LsOptions,
+  MkdirOptions,
+  RmOptions,
+} from "./FileSystemProvider.ts";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+/**
+ * Web-standard implementation of FileSystemProvider for Cloudflare Workers and other edge runtimes.
+ *
+ * Uses only Web APIs (ReadableStream, TextEncoder, etc.) — no Node.js-specific APIs.
+ * Provides working `createFile` with proper streaming support.
+ * Filesystem operations (rm, cp, mv, etc.) are not available in edge runtimes and will throw.
+ *
+ * @example
+ * ```typescript
+ * const fs = alepha.inject(WorkerdFileSystemProvider);
+ *
+ * // Create from text (returns FileLike with web ReadableStream)
+ * const file = fs.createFile({ text: "Hello!", name: "greeting.txt" });
+ * const stream = file.stream(); // ReadableStream (web standard)
+ * ```
+ */
+export class WorkerdFileSystemProvider implements FileSystemProvider {
+  protected detector = $inject(FileDetector);
+  protected json = $inject(Json);
+
+  protected encoder = new TextEncoder();
+  protected decoder = new TextDecoder();
+
+  public join(...paths: string[]): string {
+    const joined = paths.join("/").replace(/\/+/g, "/");
+    const parts = joined.split("/");
+    const resolved: string[] = [];
+    for (const part of parts) {
+      if (part === "..") {
+        resolved.pop();
+      } else if (part !== ".") {
+        resolved.push(part);
+      }
+    }
+    return resolved.join("/") || ".";
+  }
+
+  public createFile(options: CreateFileOptions): FileLike {
+    if ("text" in options) {
+      return this.createFileFromText(options.text, {
+        type: options.type,
+        name: options.name,
+      });
+    }
+
+    if ("arrayBuffer" in options) {
+      return this.createFileFromArrayBuffer(options.arrayBuffer, {
+        type: options.type,
+        name: options.name,
+      });
+    }
+
+    if ("buffer" in options) {
+      const ab =
+        options.buffer instanceof ArrayBuffer
+          ? options.buffer
+          : options.buffer.buffer.slice(
+              options.buffer.byteOffset,
+              options.buffer.byteOffset + options.buffer.byteLength,
+            );
+      return this.createFileFromArrayBuffer(ab as ArrayBuffer, {
+        type: options.type,
+        name: options.name,
+      });
+    }
+
+    if ("file" in options) {
+      return this.createFileFromWebFile(options.file, {
+        type: options.type,
+        name: options.name,
+        size: options.size,
+      });
+    }
+
+    if ("response" in options) {
+      return this.createFileFromResponse(options.response, {
+        type: options.type,
+        name: options.name,
+      });
+    }
+
+    if ("stream" in options) {
+      return this.createFileFromStream(options.stream as ReadableStream, {
+        type: options.type,
+        name: options.name,
+        size: options.size,
+      });
+    }
+
+    if ("url" in options) {
+      return this.createFileFromUrl(options.url, {
+        type: options.type,
+        name: options.name,
+      });
+    }
+
+    if ("path" in options) {
+      throw new AlephaError(
+        "WorkerdFileSystemProvider.createFile: 'path' source is not supported in edge runtimes.",
+      );
+    }
+
+    throw new AlephaError(
+      "WorkerdFileSystemProvider.createFile: unsupported options.",
+    );
+  }
+
+  // -------------------------------------------------------------------------------------------------------------------
+
+  protected createFileFromText(
+    text: string,
+    options: { type?: string; name?: string } = {},
+  ): FileLike {
+    const encoded = this.encoder.encode(text);
+    const name = options.name ?? "file.txt";
+    return {
+      name,
+      type: options.type ?? this.detector.getContentType(name),
+      size: encoded.byteLength,
+      lastModified: Date.now(),
+      stream: () =>
+        new ReadableStream({
+          start(controller) {
+            controller.enqueue(encoded);
+            controller.close();
+          },
+        }),
+      arrayBuffer: async () =>
+        encoded.buffer.slice(
+          encoded.byteOffset,
+          encoded.byteOffset + encoded.byteLength,
+        ) as ArrayBuffer,
+      text: async () => text,
+    };
+  }
+
+  protected createFileFromArrayBuffer(
+    source: ArrayBuffer,
+    options: { type?: string; name?: string } = {},
+  ): FileLike {
+    const name = options.name ?? "file";
+    const bytes = new Uint8Array(source);
+    return {
+      name,
+      type: options.type ?? this.detector.getContentType(name),
+      size: source.byteLength,
+      lastModified: Date.now(),
+      stream: () =>
+        new ReadableStream({
+          start(controller) {
+            controller.enqueue(bytes);
+            controller.close();
+          },
+        }),
+      arrayBuffer: async () => source,
+      text: async () => this.decoder.decode(source),
+    };
+  }
+
+  protected createFileFromWebFile(
+    source: File,
+    options: { type?: string; name?: string; size?: number } = {},
+  ): FileLike {
+    const name = options.name ?? source.name;
+    return {
+      name,
+      type: options.type ?? (source.type || this.detector.getContentType(name)),
+      size: options.size ?? source.size ?? 0,
+      lastModified: source.lastModified || Date.now(),
+      stream: () => source.stream(),
+      arrayBuffer: async () => await source.arrayBuffer(),
+      text: async () => await source.text(),
+    };
+  }
+
+  protected createFileFromResponse(
+    response: Response,
+    options: { type?: string; name?: string } = {},
+  ): FileLike {
+    if (!response.body) {
+      throw new AlephaError("Response has no body stream");
+    }
+
+    const sizeHeader = response.headers.get("content-length");
+    const size = sizeHeader ? parseInt(sizeHeader, 10) : 0;
+
+    let name = options.name;
+    if (!name) {
+      const cd = response.headers.get("content-disposition");
+      if (cd) {
+        const match = cd.match(/filename="?([^"]+)"?/);
+        if (match) {
+          name = match[1];
+        }
+      }
+    }
+    name ??= "file";
+
+    const type =
+      options.type ?? response.headers.get("content-type") ?? undefined;
+
+    return {
+      name,
+      type: type ?? this.detector.getContentType(name),
+      size,
+      lastModified: Date.now(),
+      stream: () => response.body!,
+      arrayBuffer: async () => await response.arrayBuffer(),
+      text: async () => await response.text(),
+    };
+  }
+
+  protected createFileFromStream(
+    source: ReadableStream,
+    options: { type?: string; name?: string; size?: number } = {},
+  ): FileLike {
+    const name = options.name ?? "file";
+    let buffer: ArrayBuffer | null = null;
+
+    const consumeStream = async (): Promise<ArrayBuffer> => {
+      if (buffer) return buffer;
+      const reader = source.getReader();
+      const chunks: Uint8Array[] = [];
+      let done = false;
+      while (!done) {
+        const result = await reader.read();
+        done = result.done;
+        if (result.value) {
+          chunks.push(result.value);
+        }
+      }
+      const total = chunks.reduce((sum, c) => sum + c.byteLength, 0);
+      const merged = new Uint8Array(total);
+      let offset = 0;
+      for (const chunk of chunks) {
+        merged.set(chunk, offset);
+        offset += chunk.byteLength;
+      }
+      buffer = merged.buffer as ArrayBuffer;
+      return buffer;
+    };
+
+    return {
+      name,
+      type: options.type ?? this.detector.getContentType(name),
+      size: options.size ?? 0,
+      lastModified: Date.now(),
+      stream: () => source,
+      arrayBuffer: consumeStream,
+      text: async () => this.decoder.decode(await consumeStream()),
+    };
+  }
+
+  protected createFileFromUrl(
+    url: string,
+    options: { type?: string; name?: string } = {},
+  ): FileLike {
+    const parsedUrl = new URL(url);
+    const name = options.name ?? parsedUrl.pathname.split("/").pop() ?? "file";
+
+    return {
+      name,
+      type: options.type ?? this.detector.getContentType(name),
+      size: 0,
+      lastModified: Date.now(),
+      stream: () => {
+        throw new AlephaError(
+          "WorkerdFileSystemProvider: streaming from URL is not supported. Use fetch() and createFile({ response }) instead.",
+        );
+      },
+      arrayBuffer: async () => {
+        const res = await fetch(url);
+        return await res.arrayBuffer();
+      },
+      text: async () => {
+        const res = await fetch(url);
+        return await res.text();
+      },
+    };
+  }
+
+  // -------------------------------------------------------------------------------------------------------------------
+  // Filesystem operations — not available in edge runtimes
+  // -------------------------------------------------------------------------------------------------------------------
+
+  public async rm(_path: string, _options?: RmOptions): Promise<void> {
+    throw new AlephaError(
+      "WorkerdFileSystemProvider: rm() is not available in edge runtimes.",
+    );
+  }
+
+  public async cp(
+    _src: string,
+    _dest: string,
+    _options?: CpOptions,
+  ): Promise<void> {
+    throw new AlephaError(
+      "WorkerdFileSystemProvider: cp() is not available in edge runtimes.",
+    );
+  }
+
+  public async mv(_src: string, _dest: string): Promise<void> {
+    throw new AlephaError(
+      "WorkerdFileSystemProvider: mv() is not available in edge runtimes.",
+    );
+  }
+
+  public async mkdir(_path: string, _options?: MkdirOptions): Promise<void> {
+    throw new AlephaError(
+      "WorkerdFileSystemProvider: mkdir() is not available in edge runtimes.",
+    );
+  }
+
+  public async ls(_path: string, _options?: LsOptions): Promise<string[]> {
+    throw new AlephaError(
+      "WorkerdFileSystemProvider: ls() is not available in edge runtimes.",
+    );
+  }
+
+  public async exists(_path: string): Promise<boolean> {
+    throw new AlephaError(
+      "WorkerdFileSystemProvider: exists() is not available in edge runtimes.",
+    );
+  }
+
+  public async readFile(_path: string): Promise<Buffer> {
+    throw new AlephaError(
+      "WorkerdFileSystemProvider: readFile() is not available in edge runtimes.",
+    );
+  }
+
+  public async writeFile(
+    _path: string,
+    _data: Uint8Array | Buffer | string | FileLike,
+  ): Promise<void> {
+    throw new AlephaError(
+      "WorkerdFileSystemProvider: writeFile() is not available in edge runtimes.",
+    );
+  }
+
+  public async readTextFile(_path: string): Promise<string> {
+    throw new AlephaError(
+      "WorkerdFileSystemProvider: readTextFile() is not available in edge runtimes.",
+    );
+  }
+
+  public async readJsonFile<T = unknown>(_path: string): Promise<T> {
+    throw new AlephaError(
+      "WorkerdFileSystemProvider: readJsonFile() is not available in edge runtimes.",
+    );
+  }
+}

package/assets/devtools-ui/chunk.2NYaoqWt.js

@@ -1 +0,0 @@
-var O=Object.defineProperty;var l=(r,o)=>O(r,"name",{value:o,configurable:!0});import{a as U,Y as _,D as H,r as a,j as e,a5 as J,Z as Y,P as c,F as I,ae as G,G as K,a4 as $,T as x,U as k,ag as W,ad as Z,ac as q}from"./entry.GYhBVRpC.js";import{d as Q}from"./chunk.CpyDMr6O.js";import{a as X}from"./chunk.C8mlBrjW.js";import{A as R}from"./chunk.DpRnB4vJ.js";import{I as z}from"./chunk.C79YouPp.js";import{u as ee,I as te,T as se}from"./chunk.B052Z_xQ.js";import"./chunk.sRNuTYXb.js";import"./chunk.dwU3E_MU.js";import"./chunk.BOHgdTP-.js";import"./chunk.BKF9JxIo.js";import"./chunk.lJL-lgnW.js";import"./chunk.WjpsbQAv.js";import"./chunk.CZl6J9DF.js";import"./chunk.CK0ow3AZ.js";import"./chunk.r_Xoa_CI.js";import"./chunk.thjBxvCA.js";import"./chunk.Ce6_6iIF.js";import"./chunk.CyPmvPnY.js";import"./chunk.tUjcyX5C.js";const oe=Z.object({}),ne=l(r=>{if(!r)return null;try{const o=q(r);if(o?.properties)return o}catch{}return null},"toTypeBoxSchema"),re=l(({entity:r,record:o,isNew:s,onSave:d,onDelete:j,pkColumn:b})=>{const f=a.useMemo(()=>{const S=s?r.insertSchema:r.updateSchema;return ne(S)??oe},[r,s]),h=ee({schema:f,handler:l(()=>{},"handler"),initialValues:s?void 0:o},[f,o,s]);return e.jsxs(c,{direction:"column",gap:"md",children:[e.jsxs(c,{justify:"space-between",children:[e.jsx(x,{fz:"sm",fw:600,children:s?"New Record":`Edit Record (${b}: ${o?.[b]})`}),e.jsxs(c,{gap:"xs",children:[e.jsx(R,{size:"xs",onClick:l(()=>d(h.currentValues),"onClick"),children:s?"Create":"Save"}),!s&&e.jsx(R,{size:"sm",variant:"light",intent:"danger",onClick:j,icon:e.jsx(te,{size:14})})]})]}),e.jsx(se,{form:h,skipSubmitButton:!0,skipFormElement:!0,columns:1})]})},"RecordForm"),ae=l(r=>{const o="/db/editor/";if(!r.startsWith(o))return{table:"",recordId:""};const s=r.slice(o.length),d=s.indexOf("/");return d===-1?{table:decodeURIComponent(s),recordId:""}:{table:decodeURIComponent(s.slice(0,d)),recordId:decodeURIComponent(s.slice(d+1))}},"parseEditorPath"),ce=l(({entities:r})=>{const o=U(_),s=H(),[d,j]=a.useState([]),[b,f]=a.useState(!1),[h,S]=a.useState(""),[w,D]=a.useState(null),{table:n,recordId:y}=ae(s.pathname),m=y==="new",v=r.find(t=>t.name===n),p=v?.columns?.find(t=>t.primaryKey)?.name??"id",g=a.useCallback(async()=>{if(n){f(!0);try{const t=await o.fetch(`/__devtools/api/db/${n}/records?size=50`);j(t.data?.content??[]),D(t.data?.page)}catch{j([])}finally{f(!1)}}},[o,n]);a.useEffect(()=>{g()},[n,g]);const u=a.useMemo(()=>!y||m?null:d.find(t=>String(t[p])===y)??null,[d,y,m,p]),E=a.useCallback(t=>{s.push(`/db/editor/${encodeURIComponent(t)}`)},[s]),L=a.useCallback(t=>{const i=t[p];s.push(`/db/editor/${encodeURIComponent(n)}/${encodeURIComponent(String(i))}`)},[s,n,p]),T=a.useCallback(()=>{s.push(`/db/editor/${encodeURIComponent(n)}/new`)},[s,n]),P=l(async t=>{try{if(m)await o.fetch(`/__devtools/api/db/${n}/records`,{method:"POST",body:JSON.stringify(t),headers:{"Content-Type":"application/json"}}),s.push(`/db/editor/${encodeURIComponent(n)}`);else if(u){const i=u[p];await o.fetch(`/__devtools/api/db/${n}/records/${i}`,{method:"PUT",body:JSON.stringify(t),headers:{"Content-Type":"application/json"}})}await g()}catch{}},"handleSave"),B=l(async()=>{if(!u)return;const t=u[p];try{await o.fetch(`/__devtools/api/db/${n}/records/${t}`,{method:"DELETE"}),s.push(`/db/editor/${encodeURIComponent(n)}`),await g()}catch{}},"handleDelete"),F=a.useMemo(()=>r.filter(i=>i.name.toLowerCase().includes(h.toLowerCase())).map(i=>({id:`entity:${i.name}`,label:i.name,icon:e.jsx(Y,{size:13,color:"var(--mantine-color-blue-text)",style:{flexShrink:0}}),badge:e.jsx(J,{size:"xs",variant:"light",color:"gray",children:i.columns?.length??0})})),[r,h]),M=a.useCallback(t=>{const i=t.replace(/^entity:/,"");E(i)},[E]),V=a.useMemo(()=>new Set,[]),A=n?`entity:${n}`:"";return e.jsxs(c,{style:{flex:1,overflow:"hidden"},children:[e.jsxs(c,{w:200,style:{borderRight:`1px solid ${I.colors.border}`,flexShrink:0,display:"flex",flexDirection:"column"},children:[e.jsx(c,{p:"xs",children:e.jsx(G,{size:"xs",placeholder:"Filter tables...",leftSection:e.jsx(K,{size:14}),value:h,onChange:l(t=>S(t.currentTarget.value),"onChange")})}),e.jsx($,{style:{flex:1},px:"xs",children:e.jsx(X,{nodes:F,selectedId:A,openNodes:V,onSelect:M,onToggle:l(()=>{},"onToggle"),showLeafCount:!1})})]}),n&&e.jsxs(c,{w:200,style:{borderRight:`1px solid ${I.colors.border}`,flexShrink:0,display:"flex",flexDirection:"column"},children:[e.jsx(c,{px:"xs",py:"xs",style:{borderBottom:`1px solid ${I.colors.border}`,flexShrink:0},children:e.jsxs(c,{gap:"xs",justify:"space-between",children:[e.jsxs(x,{fz:10,c:"dimmed",tt:"uppercase",fw:600,lts:.5,children:["Records"," ",w?.totalElements!=null&&`(${w.totalElements})`]}),e.jsx(R,{size:"xs",variant:"subtle",color:"teal",onClick:T,icon:e.jsx(z,{size:14})})]})}),e.jsxs($,{style:{flex:1},px:"xs",py:"xs",children:[e.jsx(k,{w:"100%",py:4,className:"devtools-tree-node","data-selected":m||void 0,style:{borderRadius:6,paddingLeft:8,paddingRight:8,transition:"background 100ms ease"},onClick:T,children:e.jsxs(c,{gap:8,wrap:"nowrap",children:[e.jsx(z,{size:13,color:"var(--mantine-color-teal-text)",style:{flexShrink:0}}),e.jsx(x,{fz:12,c:"teal",children:"New Record"})]})}),b?e.jsx(c,{justify:"center",py:"md",children:e.jsx(W,{size:"xs"})}):d.map((t,i)=>{const C=t[p]??i,N=!m&&String(C)===y;return e.jsx(k,{w:"100%",py:4,className:"devtools-tree-node","data-selected":N||void 0,style:{borderRadius:6,paddingLeft:8,paddingRight:8,transition:"background 100ms ease"},onClick:l(()=>L(t),"onClick"),children:e.jsxs(x,{fz:12,ff:"monospace",truncate:!0,children:[p,": ",String(C)]})},String(C))})]})]}),e.jsxs(c,{style:{flex:1,overflow:"auto"},p:"md",children:[!n&&e.jsx(c,{align:"center",justify:"center",h:"100%",children:e.jsx(x,{c:"dimmed",fz:"sm",children:"Select a table to browse records"})}),n&&!u&&!m&&e.jsx(c,{align:"center",justify:"center",h:"100%",children:e.jsx(x,{c:"dimmed",fz:"sm",children:"Select a record or create a new one"})}),(u||m)&&v&&e.jsx(re,{entity:v,record:u,isNew:m,onSave:P,onDelete:B,pkColumn:p})]})]})},"DatabaseEditor"),Te=l(()=>{const r=U(_),[o,s]=a.useState([]);return a.useEffect(()=>{r.fetch("/__devtools/api/metadata",{schema:{response:Q}}).then(d=>s(d.data.entities??[])).catch(()=>{})},[r]),e.jsx(ce,{entities:o})},"DatabaseEditorPage");export{Te as default};