@fedify/sveltekit 1.9.0-dev.1461

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright 2024–2025 Hong Minhee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+<!-- deno-fmt-ignore-file -->
+
+@fedify/sveltekit: Integrate Fedify with SvelteKit
+==================================================
+
+[![JSR][JSR badge]][JSR]
+[![npm][npm badge]][npm]
+[![Follow @fedify@hollo.social][@fedify@hollo.social badge]][@fedify@hollo.social]
+
+*This package is available since Fedify 1.9.0.*
+
+This package provides a simple way to integrate [Fedify] with [SvelteKit].
+
+The integration code looks like this:
+
+~~~~ typescript
+import { createFederation } from "@fedify/fedify";
+import { fedifyHook } from "@fedify/sveltekit";
+
+const federation = createFederation<string>({
+  // Omitted for brevity; see the related section for details.
+});
+
+// This is the entry point to the Fedify hook from the SvelteKit framework:
+export const handle = fedifyHook(federation, (req) => "context data");
+~~~~
+
+Put the above code in your *hooks.server.ts* file.
+
+How it works
+------------
+
+Fedify behaves as a hook handler that wraps around the SvelteKit request handler.
+The hook intercepts the incoming HTTP requests and dispatches them to
+the appropriate handler based on the request path and the `Accept` header
+(i.e., content negotiation).  This architecture allows Fedify and your SvelteKit
+application to coexist in the same domain and port.
+
+For example, if you make a request to */.well-known/webfinger* Fedify will
+handle the request by itself, but if you make a request to */users/alice*
+(assuming your SvelteKit app has a handler for `/users/[handle]`) with `Accept:
+text/html` header, Fedify will dispatch the request to the SvelteKit app's
+appropriate handler for `/users/[handle]`.  Or if you define an actor dispatcher
+for `/users/{handle}` in Fedify, and the request is made with `Accept:
+application/activity+json` header, Fedify will dispatch the request to the
+appropriate actor dispatcher.
+
+Installation
+------------
+
+~~~~ sh
+deno add jsr:@fedify/sveltekit  # Deno
+npm  add     @fedify/sveltekit  # npm
+pnpm add     @fedify/sveltekit  # pnpm
+yarn add     @fedify/sveltekit  # Yarn
+bun  add     @fedify/sveltekit  # Bun
+~~~~
+
+[JSR]: https://jsr.io/@fedify/sveltekit
+[JSR badge]: https://jsr.io/badges/@fedify/sveltekit
+[npm]: https://www.npmjs.com/package/@fedify/sveltekit
+[npm badge]: https://img.shields.io/npm/v/@fedify/sveltekit?logo=npm
+[@fedify@hollo.social badge]: https://fedi-badge.deno.dev/@fedify@hollo.social/followers.svg
+[@fedify@hollo.social]: https://hollo.social/@fedify
+[Fedify]: https://fedify.dev/
+[SvelteKit]: https://kit.svelte.dev/

package/dist/mod.d.ts

@@ -0,0 +1,33 @@
+import { Federation } from "@fedify/fedify/federation";
+
+//#region src/mod.d.ts
+
+type RequestEvent = {
+  request: Request;
+};
+type HookParams = {
+  event: RequestEvent;
+  resolve: (event: RequestEvent) => Promise<Response>;
+};
+/**
+ * Create a SvelteKit hook handler to integrate with the {@link Federation}
+ * object.
+ *
+ * @example hooks.server.ts
+ * ``` typescript
+ * import { federation } from "./federation"; // Import the `Federation` object
+ *
+ * export const handle = fedifyHook(federation, () => undefined);
+ * ```
+ *
+ * @template TContextData A type of the context data for the {@link Federation}
+ *                         object.
+ * @param federation A {@link Federation} object to integrate with SvelteKit.
+ * @param createContextData A function to create a context data for the
+ *                          {@link Federation} object.
+ * @returns A SvelteKit hook handler.
+ * @since 1.9.0
+ */
+declare function fedifyHook<TContextData>(federation: Federation<TContextData>, createContextData: (event: RequestEvent) => TContextData | Promise<TContextData>): (params: HookParams) => Promise<Response>;
+//#endregion
+export { fedifyHook };

package/dist/mod.js

@@ -0,0 +1,52 @@
+//#region src/mod.ts
+/**
+* Create a SvelteKit hook handler to integrate with the {@link Federation}
+* object.
+*
+* @example hooks.server.ts
+* ``` typescript
+* import { federation } from "./federation"; // Import the `Federation` object
+*
+* export const handle = fedifyHook(federation, () => undefined);
+* ```
+*
+* @template TContextData A type of the context data for the {@link Federation}
+*                         object.
+* @param federation A {@link Federation} object to integrate with SvelteKit.
+* @param createContextData A function to create a context data for the
+*                          {@link Federation} object.
+* @returns A SvelteKit hook handler.
+* @since 1.9.0
+*/
+function fedifyHook(federation, createContextData) {
+	return async ({ event, resolve }) => {
+		return await federation.fetch(event.request, {
+			contextData: await createContextData(event),
+			...integrateFetchOptions({
+				event,
+				resolve
+			})
+		});
+	};
+}
+function integrateFetchOptions({ event, resolve }) {
+	return {
+		async onNotFound() {
+			return await resolve(event);
+		},
+		async onNotAcceptable() {
+			const res = await resolve(event);
+			if (res.status !== 404) return res;
+			return new Response("Not acceptable", {
+				status: 406,
+				headers: {
+					"Content-Type": "text/plain",
+					Vary: "Accept"
+				}
+			});
+		}
+	};
+}
+
+//#endregion
+export { fedifyHook };

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@fedify/sveltekit",
+  "version": "1.9.0-dev.1461+7957aafe",
+  "description": "Integrate Fedify with SvelteKit",
+  "keywords": [
+    "Fedify",
+    "ActivityPub",
+    "Fediverse",
+    "SvelteKit",
+    "Svelte"
+  ],
+  "author": {
+    "name": "Hong Minhee",
+    "email": "hong@minhee.org",
+    "url": "https://hongminhee.org/"
+  },
+  "homepage": "https://fedify.dev/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fedify-dev/fedify.git",
+    "directory": "packages/sveltekit"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/fedify-dev/fedify/issues"
+  },
+  "funding": [
+    "https://opencollective.com/fedify",
+    "https://github.com/sponsors/dahlia"
+  ],
+  "type": "module",
+  "main": "./dist/mod.js",
+  "module": "./dist/mod.js",
+  "types": "./dist/mod.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/mod.d.ts",
+        "import": "./dist/mod.js",
+        "default": "./dist/mod.js"
+      },
+      "import": {
+        "types": "./dist/mod.d.ts",
+        "import": "./dist/mod.js",
+        "default": "./dist/mod.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/",
+    "package.json"
+  ],
+  "peerDependencies": {
+    "@sveltejs/kit": "^2.0.0",
+    "@fedify/fedify": "1.9.0-dev.1461+7957aafe"
+  },
+  "devDependencies": {
+    "tsdown": "^0.12.9",
+    "typescript": "^5.9.2"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "prepublish": "tsdown",
+    "test": "deno task codegen && tsdown && cd dist/ && node --test"
+  }
+}