ocel 0.0.1-alpha.0 → 0.0.1

package/package.json

@@ -1,84 +1,171 @@
 {
   "name": "ocel",
-  "version": "0.0.1-alpha.0",
+  "version": "0.0.1",
   "type": "module",
-  "description": "The power of AWS with the DX of Vercel",
-  "bin": {
-    "ocel": "./bin/run.js"
-  },
+  "description": "ocel runtime sdk — turns cloud infrastructure into function calls",
   "files": [
-    "bin/",
     "dist/",
-    "src/",
-    "README.md"
+    "README.md",
+    "LICENSE",
+    "NOTICE"
   ],
   "exports": {
-    "./blob": {
-      "import": "./dist/blob/index.js",
-      "types": "./dist/blob/index.d.ts"
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
+    },
+    "./edge": {
+      "types": "./dist/edge.d.ts",
+      "import": "./dist/edge.js"
+    },
+    "./dns": {
+      "types": "./dist/dns.d.ts",
+      "import": "./dist/dns.js"
+    },
+    "./env-source": {
+      "types": "./dist/env-source.d.ts",
+      "import": "./dist/env-source.js"
+    },
+    "./providers/aws": {
+      "types": "./dist/providers/aws/index.d.ts",
+      "import": "./dist/providers/aws/index.js"
     },
-    "./blob/client": {
-      "import": "./dist/blob/integrations/client.js",
-      "types": "./dist/blob/integrations/client.d.ts"
+    "./providers/aws/edge": {
+      "types": "./dist/providers/aws/edge.d.ts",
+      "import": "./dist/providers/aws/edge.js"
     },
-    "./blob/*": {
-      "import": "./dist/blob/integrations/*.js",
-      "types": "./dist/blob/integrations/*.d.ts"
+    "./providers/aws/dns": {
+      "types": "./dist/providers/aws/dns.d.ts",
+      "import": "./dist/providers/aws/dns.js"
     },
-    "./lambda": {
-      "import": "./dist/lambda/index.js",
-      "types": "./dist/lambda/index.d.ts"
+    "./providers/gcp": {
+      "types": "./dist/providers/gcp/index.d.ts",
+      "import": "./dist/providers/gcp/index.js"
     },
-    "./lambda/*": {
-      "import": "./dist/lambda/integrations/*.js",
-      "types": "./dist/lambda/integrations/*.d.ts"
+    "./providers/gcp/edge": {
+      "types": "./dist/providers/gcp/edge.d.ts",
+      "import": "./dist/providers/gcp/edge.js"
     },
-    "./workflow": {
-      "import": "./dist/workflow/index.js",
-      "types": "./dist/workflow/index.d.ts"
+    "./providers/vps": {
+      "types": "./dist/providers/vps/index.d.ts",
+      "import": "./dist/providers/vps/index.js"
+    },
+    "./env": {
+      "types": "./dist/env/index.d.ts",
+      "edge-light": "./dist/env/edge.js",
+      "workerd": "./dist/env/edge.js",
+      "worker": "./dist/env/edge.js",
+      "import": "./dist/env/index.js"
+    },
+    "./env/client": {
+      "types": "./dist/env/client.d.ts",
+      "import": "./dist/env/client.js"
+    },
+    "./env/schema": {
+      "types": "./dist/env/schema.d.ts",
+      "import": "./dist/env/schema.js"
     },
     "./postgres": {
-      "import": "./dist/postgres/index.js",
-      "types": "./dist/postgres/index.d.ts"
-    }
+      "types": "./dist/postgres/index.d.ts",
+      "import": "./dist/postgres/index.js"
+    },
+    "./bucket": {
+      "types": "./dist/bucket/index.d.ts",
+      "import": "./dist/bucket/index.js"
+    },
+    "./bucket/next": {
+      "types": "./dist/bucket/next.d.ts",
+      "import": "./dist/bucket/next.js"
+    },
+    "./bucket/hono": {
+      "types": "./dist/bucket/hono.d.ts",
+      "import": "./dist/bucket/hono.js"
+    },
+    "./bucket/express": {
+      "types": "./dist/bucket/express.d.ts",
+      "import": "./dist/bucket/express.js"
+    },
+    "./bucket/client": {
+      "types": "./dist/bucket/client.d.ts",
+      "import": "./dist/bucket/client.js"
+    },
+    "./task": {
+      "types": "./dist/task/index.d.ts",
+      "import": "./dist/task/index.js"
+    },
+    "./topic": {
+      "types": "./dist/topic/index.d.ts",
+      "import": "./dist/topic/index.js"
+    },
+    "./worker": {
+      "types": "./dist/worker/index.d.ts",
+      "import": "./dist/worker/index.js"
+    },
+    "./kv": {
+      "types": "./dist/kv/index.d.ts",
+      "import": "./dist/kv/index.js"
+    },
+    "./realtime": {
+      "types": "./dist/realtime/index.d.ts",
+      "import": "./dist/realtime/index.js"
+    },
+    "./realtime/next": {
+      "types": "./dist/realtime/next.d.ts",
+      "import": "./dist/realtime/next.js"
+    },
+    "./realtime/express": {
+      "types": "./dist/realtime/express.d.ts",
+      "import": "./dist/realtime/express.js"
+    },
+    "./realtime/hono": {
+      "types": "./dist/realtime/hono.d.ts",
+      "import": "./dist/realtime/hono.js"
+    },
+    "./realtime/client": {
+      "types": "./dist/realtime/client.d.ts",
+      "import": "./dist/realtime/client.js"
+    },
+    "./package.json": "./package.json"
   },
-  "scripts": {
-    "build": "tsc",
-    "build:listener": "bun build src/blob/s3-listener.ts --outfile=dist/blob-listener/index.js --target=node --format=cjs --minify"
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ocelhq/ocel.git",
+    "directory": "packages/ocel"
   },
-  "license": "MIT",
-  "packageManager": "pnpm@10.18.3",
-  "optionalDependencies": {
-    "@ocel/linux-x64": "^0.0.1-alpha.0",
-    "@ocel/win32-x64": "^0.0.1-alpha.0",
-    "@ocel/darwin-arm64": "^0.0.1-alpha.0",
-    "@ocel/darwin-x64": "^0.0.1-alpha.0"
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.12.1",
+    "@connectrpc/connect": "^2.1.2",
+    "@connectrpc/connect-node": "^2.1.2",
+    "@standard-schema/spec": "^1.1.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/aws-lambda": "^8.10.160",
     "@types/express": "~5.0.0",
+    "@types/ioredis-mock": "^8.2.8",
+    "@types/pg": "^8.20.0",
+    "@types/ws": "^8.18.2",
     "express": "~5.0.0",
     "hono": "~4.11.1",
-    "typescript": "^5.9.3"
-  },
-  "dependencies": {
-    "@aws-sdk/client-dynamodb": "^3.958.0",
-    "@aws-sdk/client-lambda": "^3.958.0",
-    "@aws-sdk/client-s3": "^3.958.0",
-    "@aws-sdk/client-xray": "^3.958.0",
-    "@aws-sdk/s3-request-presigner": "^3.958.0",
-    "@aws/durable-execution-sdk-js": "^1.0.1",
-    "@opentelemetry/api": "^1.9.0",
-    "@sindresorhus/slugify": "^3.0.0",
-    "electrodb": "^3.5.0",
-    "nanoid": "^5.1.6",
-    "serverless-http": "^4.0.0",
-    "zod": "^4.2.1"
+    "ioredis": "^5.11.1",
+    "ioredis-mock": "^8.13.1",
+    "next": "16.2.10",
+    "pg": "^8.22.0",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "typescript": "^5.9.3",
+    "vite": "^8.1.3",
+    "vitest": "^4.1.9",
+    "ws": "^8.21.0"
   },
   "peerDependencies": {
-    "hono": ">=4.11.1",
     "@types/express": ">=5.0.0",
-    "express": ">=5.0.0"
+    "express": ">=5.0.0",
+    "hono": ">=4.11.1",
+    "ioredis": ">=5",
+    "next": ">=14",
+    "pg": "^8.22.0"
   },
   "peerDependenciesMeta": {
     "hono": {
@@ -89,10 +176,24 @@
     },
     "express": {
       "optional": true
+    },
+    "next": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
     }
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.typecheck.json && tsc --noEmit -p tsconfig.typetests-config.json"
   }
-}
+}

package/bin/run.js

@@ -1,39 +0,0 @@
-#!/usr/bin/env node
-
-import { join } from "path";
-import { createRequire } from "node:module";
-
-const { platform, arch } = process;
-const require = createRequire(import.meta.url);
-
-let packageName = "";
-
-switch (platform) {
-  case "win32":
-    packageName = `win32-${arch}`;
-    break;
-  case "darwin":
-    packageName = `darwin-${arch}`;
-    break;
-  case "linux":
-    packageName = `linux-${arch}`;
-    break;
-  default:
-    throw new Error(`Unsupported platform: ${platform}`);
-}
-
-const binaryPkg = `@ocel/${packageName}`;
-
-try {
-  const binary = process.platform === "win32" ? "ocel.exe" : "ocel";
-  const binaryPath = require.resolve(join(binaryPkg, "bin", binary));
-
-  const { spawnSync } = require("child_process");
-  const result = spawnSync(binaryPath, process.argv.slice(2), {
-    stdio: "inherit",
-  });
-  process.exit(result.status);
-} catch (e) {
-  console.error(`Failed to locate binary for ${binaryPkg}.`);
-  process.exit(1);
-}

package/dist/blob/bucket.d.ts

@@ -1,55 +0,0 @@
-import type { IncomingMessage } from "node:http";
-import type { HandleUploadBody, TBucketConfig, TUploaderConfig } from "./types";
-import type { Component } from "../utils/component";
-export declare class Bucket<TUploaderShape extends Record<string, TUploaderConfig<any, any>>> implements Component {
-    readonly name: string;
-    readonly _shape: TUploaderShape;
-    private uploaders;
-    constructor(name: string, args: TBucketConfig<TUploaderShape>);
-    __id(): string;
-    __name(): string;
-    upload: () => Promise<void>;
-    uploadExternal: () => Promise<void>;
-    handleUpload: ({ body, request, }: {
-        request: Request | IncomingMessage;
-        body: HandleUploadBody;
-    }) => Promise<{
-        files: {
-            url: string;
-            key: string;
-            name: string;
-        }[];
-        sessionId: string;
-    } | {
-        files: {
-            fileKey: string;
-            status: "PENDING" | "SUCCESS" | "FAILED";
-            file: {
-                path: string;
-                contentDisposition: string;
-                contentType: string;
-            } | undefined;
-            metadata: any;
-        }[];
-        completed: boolean;
-        type?: undefined;
-        response?: undefined;
-        error?: undefined;
-    } | {
-        type: "UPLOAD_COMPLETED";
-        response: "ok";
-        files?: undefined;
-        completed?: undefined;
-        error?: undefined;
-    } | {
-        error: {
-            message: string;
-            code: string;
-            status: number;
-        };
-        files?: undefined;
-        completed?: undefined;
-        type?: undefined;
-        response?: undefined;
-    }>;
-}

package/dist/blob/bucket.js

@@ -1,65 +0,0 @@
-import z from "zod";
-import { getCallerFile } from "../utils/stack";
-import { rpc } from "../utils/rpc";
-import { Uploader } from "./uploader";
-import { parseReq } from "./parse";
-export class Bucket {
-    name;
-    _shape = {};
-    uploaders = {};
-    constructor(name, args) {
-        this.name = name;
-        if (process.env.OCEL_PHASE === "discovery") {
-            rpc.register({
-                id: name,
-                type: "bucket",
-                source: getCallerFile() || "unknown",
-                // TODO:
-                config: {},
-            });
-        }
-        this._shape = args.uploaders;
-        Object.entries(args.uploaders).forEach(([key, config]) => {
-            this.uploaders[key] = new Uploader(this, key, config);
-        });
-    }
-    __id() {
-        return this.name;
-    }
-    __name() {
-        const id = process.env[`RESOURCE_${this.name}_BUCKET_NAME`];
-        if (!id) {
-            throw new Error(`Bucket ID for bucket "${this.name}" is not defined. Make sure the bucket is properly configured in your Ocel project.`);
-        }
-        return id;
-    }
-    upload = async () => { };
-    uploadExternal = async () => { };
-    handleUpload = async ({ body, request, }) => {
-        const parsedReq = parseReq(request);
-        const hasUploaders = Object.keys(this._shape).length > 0;
-        if (!hasUploaders) {
-            throw new Error("No uploaders configured for this bucket");
-        }
-        const querySchema = z.object({
-            action: z.enum(["presign", "callback", "poll"]),
-            uploader: z.enum(Object.keys(this._shape)),
-            sessionId: z.string().optional(),
-        });
-        const queryRes = querySchema.safeParse(Object.fromEntries(parsedReq.query));
-        if (!queryRes.success) {
-            throw new Error(`Invalid query parameters: ${queryRes.error.message}`);
-        }
-        const query = queryRes.data;
-        const uploader = this.uploaders[query.uploader];
-        if (!uploader) {
-            throw new Error(`Uploader not found: ${query.uploader}`);
-        }
-        return uploader.handleUpload({
-            body,
-            request,
-            action: query.action,
-            sessionId: query.sessionId,
-        });
-    };
-}

package/dist/blob/index.d.ts

@@ -1,8 +0,0 @@
-import { type ZodType } from "zod";
-import type { TBucketConfig, TUploaderConfig } from "./types";
-import { Bucket } from "./bucket";
-export declare function bucket<TUploaderShape extends Record<string, TUploaderConfig<any, any>>>(name: string, args: TBucketConfig<TUploaderShape>): Bucket<TUploaderShape>;
-export declare function uploader<TInput extends ZodType = never, TMeta = never, TReturn = void>({ middleware, input, }: {
-    input?: TInput;
-    middleware: TUploaderConfig<TInput, TMeta, TReturn>["onBeforeUpload"];
-}, config: Omit<TUploaderConfig<TInput, TMeta, TReturn>, "onBeforeUpload" | "_def" | "input">): TUploaderConfig<TInput, TMeta, TReturn>;

package/dist/blob/index.js

@@ -1,13 +0,0 @@
-import {} from "zod";
-import { Bucket } from "./bucket";
-export function bucket(name, args) {
-    return new Bucket(name, args);
-}
-export function uploader({ middleware, input, }, config) {
-    return {
-        ...config,
-        input,
-        onBeforeUpload: middleware,
-        _def: {},
-    };
-}

package/dist/blob/integrations/client.d.ts

@@ -1,25 +0,0 @@
-import type z from "zod";
-import type { Bucket } from "../bucket";
-type InferReturn<TRouter, K extends keyof TRouter> = TRouter[K] extends {
-    _def: {
-        output: infer R;
-    };
-} ? R : never;
-type InferInput<TRouter, K extends keyof TRouter> = TRouter[K] extends {
-    _def: {
-        input: infer R;
-    };
-} ? R : never;
-export declare function createUploadClient<TBucket extends Bucket<any>>(opts: {
-    url: string;
-}): {
-    upload: <K extends keyof TBucket["_shape"]>(uploader: K, args: InferInput<TBucket["_shape"], K> extends never ? {
-        files: File[];
-        onClientUploadComplete?: (res: InferReturn<TBucket["_shape"], K>) => void;
-    } : {
-        files: File[];
-        input: z.infer<InferInput<TBucket["_shape"], K>>;
-        onClientUploadComplete?: (res: InferReturn<TBucket["_shape"], K>) => void;
-    }) => Promise<void>;
-};
-export {};

package/dist/blob/integrations/client.js

@@ -1,71 +0,0 @@
-export function createUploadClient(opts) {
-    return {
-        upload: async (uploader, args) => {
-            const url = opts.url;
-            const searchParams = new URLSearchParams();
-            searchParams.append("action", "presign");
-            searchParams.append("uploader", String(uploader));
-            // get presign urls
-            const result = (await fetch(`${url}?${searchParams.toString()}`, {
-                method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                },
-                body: JSON.stringify({
-                    files: args.files.map((f) => {
-                        return {
-                            name: f.name,
-                            size: f.size,
-                            type: f.type,
-                            lastModified: f.lastModified,
-                            mimeType: f.type,
-                        };
-                    }),
-                    ...("input" in args ? { input: args.input } : {}),
-                }),
-            }).then((r) => r.json()));
-            // upload files to presign urls (sessionId required for S3 listener to update DynamoDB)
-            await Promise.all(args.files.map((file, index) => {
-                if (!result.files[index]?.url) {
-                    throw new Error(`No presign URL returned for file index ${index}`);
-                }
-                return fetch(result.files[index].url, {
-                    method: "PUT",
-                    headers: {
-                        "Content-Type": file.type,
-                        "Content-Disposition": "inline",
-                    },
-                    body: file,
-                });
-            }));
-            // poll for completion (S3 listener Lambda updates DynamoDB when upload lands)
-            const pollParams = new URLSearchParams();
-            pollParams.append("action", "poll");
-            pollParams.append("uploader", String(uploader));
-            pollParams.append("sessionId", result.sessionId);
-            const pollUntilComplete = async () => {
-                const res = await fetch(`${url}?${pollParams.toString()}`, {
-                    method: "POST",
-                    headers: { "Content-Type": "application/json" },
-                    body: JSON.stringify({}),
-                });
-                const data = (await res.json());
-                if (data.completed)
-                    return data;
-                await new Promise((r) => setTimeout(r, 1000));
-                return pollUntilComplete();
-            };
-            const pollResult = await pollUntilComplete();
-            if (args.onClientUploadComplete && pollResult.files) {
-                const completedFiles = pollResult.files.filter((f) => f.status === "SUCCESS" && f.file);
-                const results = completedFiles.map((f) => ({
-                    file: f.file,
-                    metadata: f.metadata ?? {},
-                }));
-                if (results.length > 0) {
-                    args.onClientUploadComplete(results.length === 1 ? results[0] : results);
-                }
-            }
-        },
-    };
-}

package/dist/blob/integrations/hono.d.ts

@@ -1,31 +0,0 @@
-import type { Context } from "hono";
-import type { Bucket } from "../bucket";
-export declare function createRouteHandler(bucket: Bucket<any>): (c: Context) => Promise<Response & import("hono").TypedResponse<{
-    files: {
-        url: string;
-        key: string;
-        name: string;
-    }[];
-    sessionId: string;
-} | {
-    files: {
-        fileKey: string;
-        status: "PENDING" | "SUCCESS" | "FAILED";
-        file: {
-            path: string;
-            contentDisposition: string;
-            contentType: string;
-        } | undefined;
-        metadata: any;
-    }[];
-    completed: boolean;
-} | {
-    type: "UPLOAD_COMPLETED";
-    response: "ok";
-} | {
-    error: {
-        message: string;
-        code: string;
-        status: number;
-    };
-}, import("hono/utils/http-status").ContentfulStatusCode, "json">>;

package/dist/blob/integrations/hono.js

@@ -1,11 +0,0 @@
-export function createRouteHandler(bucket) {
-    return async (c) => {
-        const req = c.req.raw;
-        const body = (await req.json());
-        const result = await bucket.handleUpload({
-            body,
-            request: req,
-        });
-        return c.json(result);
-    };
-}

package/dist/blob/mime-types.d.ts

@@ -1 +0,0 @@
-export type KnownMimeType = "application/json" | "application/xml" | "application/octet-stream" | "application/zip" | "application/gzip" | "application/x-tar" | "application/wasm" | "application/x-7z-compressed" | "application/x-sh" | "application/*" | "text/plain" | "text/csv" | "text/html" | "text/css" | "text/javascript" | "application/javascript" | "application/typescript" | "application/pdf" | "application/rtf" | "text/*" | "image/jpeg" | "image/png" | "image/gif" | "image/webp" | "image/svg+xml" | "image/bmp" | "image/tiff" | "image/avif" | "image/vnd.microsoft.icon" | "image/*" | "audio/mpeg" | "audio/wav" | "audio/ogg" | "audio/aac" | "audio/flac" | "audio/*" | "video/mp4" | "video/webm" | "video/ogg" | "video/quicktime" | "video/x-msvideo" | "video/*" | "application/msword" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.ms-excel" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.ms-powerpoint" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/vnd.oasis.opendocument.text" | "application/vnd.oasis.opendocument.spreadsheet" | "font/otf" | "font/ttf" | "font/woff" | "font/woff2";

package/dist/blob/parse.d.ts

@@ -1,16 +0,0 @@
-import type { IncomingMessage } from "node:http";
-import type { FileSize } from "./types";
-export declare function parseReq(req: Request | IncomingMessage): {
-    headers: Record<string, string>;
-    method: string;
-    url: string;
-    path: string;
-    query: URLSearchParams;
-};
-/**
- * Converts a human-readable file size string (e.g., "10MB", "2.5GB") into bytes.
- * Throws an error for invalid input formats.
- * * @param size The file size represented as a number (bytes) or a string with units (KB, MB, GB, B).
- * @returns The size in bytes (number).
- */
-export declare function parseFileSize(size: FileSize): number;