@hulla/api-cloudflare 0.0.0-stage → 2.0.0

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { FetchServerErrorInput } from "@hulla/api/fetch";
+import { Awaitable, ServerAdapter, ServerContextInput, ServerExecutableFor } from "@hulla/api/server";
+import { Contract } from "@hulla/api";
+//#region src/index.d.ts
+/** The portable part of Cloudflare's generated `ExecutionContext` type used by an HTTP Worker. */
+type CloudflareExecutionContext = {
+  readonly passThroughOnException: () => void;
+  readonly waitUntil: (promise: Promise<unknown>) => void;
+};
+type CloudflareWorkerHandler<Env = unknown, ExecutionContext extends CloudflareExecutionContext = CloudflareExecutionContext> = (request: Request, env: Env, ctx: ExecutionContext) => Promise<Response>;
+type CloudflareAdapterContext<Env, ExecutionContext extends CloudflareExecutionContext> = {
+  readonly request: Request;
+  readonly env: Env;
+  readonly ctx: ExecutionContext;
+};
+type CloudflareHandlerContext<Env, ExecutionContext extends CloudflareExecutionContext> = {
+  readonly env: Env;
+  readonly ctx: ExecutionContext;
+};
+type CloudflareServerErrorInput<Env = unknown, ExecutionContext extends CloudflareExecutionContext = CloudflareExecutionContext> = Omit<FetchServerErrorInput<CloudflareHandlerContext<Env, ExecutionContext>>, 'handlerContext'> & {
+  readonly env: Env;
+  readonly ctx: ExecutionContext;
+};
+type CloudflareServerOptions<Env = unknown, ExecutionContext extends CloudflareExecutionContext = CloudflareExecutionContext> = {
+  readonly onError?: ((input: CloudflareServerErrorInput<Env, ExecutionContext>) => Awaitable<Response | undefined | void>) | undefined;
+};
+type CloudflareContextInput<ContractType extends Contract = Contract, Env = unknown, ExecutionContext extends CloudflareExecutionContext = CloudflareExecutionContext> = ServerContextInput<ContractType> & CloudflareAdapterContext<Env, ExecutionContext>;
+type CloudflareAdapter<Env = unknown, ExecutionContext extends CloudflareExecutionContext = CloudflareExecutionContext> = ServerAdapter<'cloudflare-workers', CloudflareAdapterContext<Env, ExecutionContext>> & {
+  readonly mount: <const ContractType extends Contract, const Context extends object>(implementation: ServerExecutableFor<ContractType, Context, 'cloudflare-workers', CloudflareAdapterContext<Env, ExecutionContext>>, options?: CloudflareServerOptions<Env, ExecutionContext>) => CloudflareWorkerHandler<Env, ExecutionContext>;
+};
+/** Creates a Cloudflare Workers adapter with native context and mounting operations. */
+declare function cloudflareAdapter<Env = unknown, ExecutionContext extends CloudflareExecutionContext = CloudflareExecutionContext>(options?: CloudflareServerOptions<Env, ExecutionContext>): CloudflareAdapter<Env, ExecutionContext>;
+//#endregion
+export { CloudflareAdapter, CloudflareContextInput, CloudflareExecutionContext, CloudflareServerErrorInput, CloudflareServerOptions, CloudflareWorkerHandler, cloudflareAdapter };

package/dist/index.js

@@ -0,0 +1,37 @@
+import { createFetchHandler } from "@hulla/api/fetch";
+import { createServerAdapter, serverContextAdapterId } from "@hulla/api/server";
+
+//#region src/index.ts
+/** Creates the `fetch` handler for a Cloudflare Module Worker. */
+function createWorkerHandler(implementation, options = {}) {
+	const usesNativeContext = serverContextAdapterId(implementation.context) !== void 0;
+	const handler = createFetchHandler(implementation, {
+		contextAdapter: "cloudflare-workers",
+		...usesNativeContext ? { contextInput: (_request, input) => input } : {},
+		...options.onError === void 0 ? {} : { onError: ({ handlerContext, ...input }) => options.onError?.({
+			...input,
+			...handlerContext
+		}) }
+	});
+	if (!usesNativeContext && options.onError === void 0) return (request) => handler(request, void 0);
+	return (request, env, ctx) => handler(request, {
+		env,
+		ctx
+	});
+}
+let cloudflareAdapterValue;
+function createCloudflareAdapter(defaults) {
+	return createServerAdapter("cloudflare-workers", { mount: (implementation, options) => createWorkerHandler(implementation, options === void 0 ? defaults : {
+		...defaults,
+		...options
+	}) });
+}
+/** Creates a Cloudflare Workers adapter with native context and mounting operations. */
+function cloudflareAdapter(options) {
+	if (options !== void 0) return createCloudflareAdapter({ ...options });
+	cloudflareAdapterValue ??= createCloudflareAdapter({});
+	return cloudflareAdapterValue;
+}
+
+//#endregion
+export { cloudflareAdapter };

package/dist/pages.d.ts

@@ -0,0 +1,34 @@
+import { FetchServerErrorInput } from "@hulla/api/fetch";
+import { Awaitable, ServerAdapter, ServerContextInput, ServerExecutableFor } from "@hulla/api/server";
+import { Contract } from "@hulla/api";
+//#region src/pages.d.ts
+type CloudflarePagesFetcher = {
+  readonly fetch: typeof fetch;
+};
+type CloudflarePagesParams<Param extends string = string> = Record<Param, string | string[]>;
+/** The native context supplied to a Cloudflare Pages Function. */
+type CloudflarePagesEventContext<Env = unknown, Param extends string = string, Data extends Record<string, unknown> = Record<string, unknown>> = {
+  readonly request: Request;
+  readonly functionPath: string;
+  readonly waitUntil: (promise: Promise<unknown>) => void;
+  readonly passThroughOnException: () => void;
+  readonly next: (input?: Request | string, init?: RequestInit) => Promise<Response>;
+  readonly env: Env & {
+    readonly ASSETS: CloudflarePagesFetcher;
+  };
+  readonly params: CloudflarePagesParams<Param>;
+  readonly data: Data;
+};
+type CloudflarePagesFunction<Env = unknown, Param extends string = string, Data extends Record<string, unknown> = Record<string, unknown>> = (context: CloudflarePagesEventContext<Env, Param, Data>) => Promise<Response>;
+type CloudflarePagesContextInput<ContractType extends Contract = Contract, Env = unknown, Param extends string = string, Data extends Record<string, unknown> = Record<string, unknown>> = ServerContextInput<ContractType> & CloudflarePagesEventContext<Env, Param, Data>;
+type CloudflarePagesServerErrorInput<Env = unknown, Param extends string = string, Data extends Record<string, unknown> = Record<string, unknown>> = Omit<FetchServerErrorInput<CloudflarePagesEventContext<Env, Param, Data>>, 'handlerContext'> & CloudflarePagesEventContext<Env, Param, Data>;
+type CloudflarePagesServerOptions<Env = unknown, Param extends string = string, Data extends Record<string, unknown> = Record<string, unknown>> = {
+  readonly onError?: ((input: CloudflarePagesServerErrorInput<Env, Param, Data>) => Awaitable<Response | undefined | void>) | undefined;
+};
+type CloudflarePagesAdapter<Env = unknown, Param extends string = string, Data extends Record<string, unknown> = Record<string, unknown>> = ServerAdapter<'cloudflare-pages', CloudflarePagesEventContext<Env, Param, Data>> & {
+  readonly mount: <const ContractType extends Contract, const Context extends object>(implementation: ServerExecutableFor<ContractType, Context, 'cloudflare-pages', CloudflarePagesEventContext<Env, Param, Data>>, options?: CloudflarePagesServerOptions<Env, Param, Data>) => CloudflarePagesFunction<Env, Param, Data>;
+};
+/** Creates a Cloudflare Pages Functions adapter with native event context and mounting operations. */
+declare function cloudflarePagesAdapter<Env = unknown, Param extends string = string, Data extends Record<string, unknown> = Record<string, unknown>>(options?: CloudflarePagesServerOptions<Env, Param, Data>): CloudflarePagesAdapter<Env, Param, Data>;
+//#endregion
+export { CloudflarePagesAdapter, CloudflarePagesContextInput, CloudflarePagesEventContext, CloudflarePagesFetcher, CloudflarePagesFunction, CloudflarePagesParams, CloudflarePagesServerErrorInput, CloudflarePagesServerOptions, cloudflarePagesAdapter };

package/dist/pages.js

@@ -0,0 +1,31 @@
+import { createFetchHandler } from "@hulla/api/fetch";
+import { createServerAdapter } from "@hulla/api/server";
+
+//#region src/pages.ts
+function createPagesHandler(implementation, options) {
+	const handler = createFetchHandler(implementation, {
+		contextAdapter: "cloudflare-pages",
+		contextInput: (_request, eventContext) => eventContext,
+		...options.onError === void 0 ? {} : { onError: ({ handlerContext, ...input }) => options.onError?.({
+			...handlerContext,
+			...input
+		}) }
+	});
+	return (eventContext) => handler(eventContext.request, eventContext);
+}
+let cloudflarePagesAdapterValue;
+function createCloudflarePagesAdapter(defaults) {
+	return createServerAdapter("cloudflare-pages", { mount: (implementation, options) => createPagesHandler(implementation, options === void 0 ? defaults : {
+		...defaults,
+		...options
+	}) });
+}
+/** Creates a Cloudflare Pages Functions adapter with native event context and mounting operations. */
+function cloudflarePagesAdapter(options) {
+	if (options !== void 0) return createCloudflarePagesAdapter({ ...options });
+	cloudflarePagesAdapterValue ??= createCloudflarePagesAdapter({});
+	return cloudflarePagesAdapterValue;
+}
+
+//#endregion
+export { cloudflarePagesAdapter };

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@hulla/api-cloudflare",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.0",
+  "description": "Cloudflare Workers and Pages Functions server adapters for @hulla/api",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hulladev/api.git",
+    "directory": "packages/cloudflare"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./pages": {
+      "types": "./dist/pages.d.ts",
+      "import": "./dist/pages.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rm -rf dist coverage",
+    "test": "bun run build && vitest run",
+    "test:coverage": "bun run build && vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@hulla/api": "2.0.0",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@hulla/api": "^2.0.0"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.