Add SvelteKit Example (#299)

## Summary
<!-- Succinctly describe your change, providing context, what you've
changed, and why. -->

Add a SvelteKit example cloned from
[joelhooks/inngest-sveltekit-example](https://github.com/joelhooks/inngest-sveltekit-example),
in addition to an `"inngest/sveltekit"` serve handler.

## Checklist
<!-- Tick these items off as you progress. -->
<!-- If an item isn't applicable, ideally please strikeout the item by
wrapping it in "~~"" and suffix it with "N/A My reason for skipping
this." -->
<!-- e.g. "- [ ] ~~Added tests~~ N/A Only touches docs" -->

- [x] Added a [docs PR](https://github.com/inngest/website) that
references this PR
- [x] Added unit/integration tests
- [x] Added changesets if applicable

## Related

- inngest/website#571

.changeset/short-worms-agree.md

@@ -0,0 +1,5 @@
+---
+"inngest": minor
+---
+
+Added a new `"inngest/sveltekit"` serve handler. See the [Framework: Sveltekit](https://www.inngest.com/docs/sdk/serve#framework-sveltekit) docs and the [`framework-sveltekit`](/examples/framework-sveltekit) example to get started.

.github/workflows/pr.yml

@@ -139,4 +139,4 @@ jobs:
           path: packages/inngest
 
       - name: Run integration tests
-        run: npx tsx scripts/integrationTestRunner.ts ${{ matrix.example }} 8288 3000
+        run: pnpm run itest ${{ matrix.example }}

examples/framework-sveltekit/.gitignore

@@ -0,0 +1,10 @@
+.DS_Store
+node_modules
+/build
+/.svelte-kit
+/package
+.env
+.env.*
+!.env.example
+vite.config.js.timestamp-*
+vite.config.ts.timestamp-*

examples/framework-sveltekit/.npmrc

@@ -0,0 +1,2 @@
+engine-strict=true
+resolution-mode=highest

examples/framework-sveltekit/.prettierignore

@@ -0,0 +1,13 @@
+.DS_Store
+node_modules
+/build
+/.svelte-kit
+/package
+.env
+.env.*
+!.env.example
+
+# Ignore files for PNPM, NPM and YARN
+pnpm-lock.yaml
+package-lock.json
+yarn.lock

examples/framework-sveltekit/.prettierrc

@@ -0,0 +1,9 @@
+{
+	"useTabs": true,
+	"singleQuote": true,
+	"trailingComma": "none",
+	"printWidth": 100,
+	"plugins": ["prettier-plugin-svelte"],
+	"pluginSearchDirs": ["."],
+	"overrides": [{ "files": "*.svelte", "options": { "parser": "svelte" } }]
+}

examples/framework-sveltekit/README.md

@@ -0,0 +1,29 @@
+# create-svelte + Inngest
+
+Everything you need to build a Svelte project, powered by [`create-svelte`](https://github.com/sveltejs/kit/tree/master/packages/create-svelte) and Inngest.
+
+## Getting Started
+
+## How to use
+
+Use [`create-next-app`](https://www.npmjs.com/package/create-next-app) with [npm](https://docs.npmjs.com/cli/init), [Yarn](https://yarnpkg.com/lang/en/docs/cli/create/), or [pnpm](https://pnpm.io) to bootstrap the example:
+
+```bash
+npx create-next-app --example https://github.com/inngest/inngest-js/tree/main/examples/framework-sveltekit inngest-sveltekit
+```
+
+```bash
+yarn create next-app --example https://github.com/inngest/inngest-js/tree/main/examples/framework-sveltekit inngest-sveltekit
+```
+
+```bash
+pnpm create next-app --example https://github.com/inngest/inngest-js/tree/main/examples/framework-sveltekit inngest-sveltekit
+```
+
+- [Inngest functions](https://www.inngest.com/docs/functions) are available at `src/lib/inngest/`.
+- The [Inngest handler](https://www.inngest.com/docs/frameworks/nextjs) is available a `src/routes/api/inngest/+server.ts`.
+
+## Learn More
+
+- [Inngest Documentation](https://www.inngest.com/docs) - learn about the Inngest SDK, functions, and events
+- [SvelteKit Documentation](https://kit.svelte.dev/docs) - learn about SvelteKit features and API.

examples/framework-sveltekit/package.json

@@ -0,0 +1,33 @@
+{
+	"name": "inngest-sveltekit-example",
+	"version": "0.0.1",
+	"private": true,
+	"scripts": {
+		"dev": "vite dev --port 3000",
+		"build": "vite build",
+		"preview": "vite preview",
+		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+		"test": "vitest",
+		"lint": "prettier --plugin-search-dir . --check .",
+		"format": "prettier --plugin-search-dir . --write ."
+	},
+	"devDependencies": {
+		"@sveltejs/adapter-auto": "^2.0.0",
+		"@sveltejs/adapter-vercel": "^3.0.3",
+		"@sveltejs/kit": "^1.20.4",
+		"prettier": "^2.8.0",
+		"prettier-plugin-svelte": "^2.10.1",
+		"svelte": "^4.0.5",
+		"svelte-check": "^3.4.3",
+		"tslib": "^2.4.1",
+		"typescript": "^5.0.0",
+		"vite": "^4.4.2",
+		"vitest": "^0.33.0"
+	},
+	"type": "module",
+	"dependencies": {
+		"h3": "^1.7.1",
+		"inngest": "^3.0.0"
+	}
+}

examples/framework-sveltekit/src/app.d.ts

@@ -0,0 +1,12 @@
+// See https://kit.svelte.dev/docs/types#app
+// for information about these interfaces
+declare global {
+	namespace App {
+		// interface Error {}
+		// interface Locals {}
+		// interface PageData {}
+		// interface Platform {}
+	}
+}
+
+export {};

examples/framework-sveltekit/src/app.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<link rel="icon" href="%sveltekit.assets%/favicon.png" />
+		<meta name="viewport" content="width=device-width" />
+		%sveltekit.head%
+	</head>
+	<body data-sveltekit-preload-data="hover">
+		<div style="display: contents">%sveltekit.body%</div>
+	</body>
+</html>

examples/framework-sveltekit/src/index.test.ts

@@ -0,0 +1,7 @@
+import { describe, it, expect } from 'vitest';
+
+describe('sum test', () => {
+	it('adds 1 + 2 to equal 3', () => {
+		expect(1 + 2).toBe(3);
+	});
+});

examples/framework-sveltekit/src/lib/index.ts

@@ -0,0 +1 @@
+// place files you want to import through the `$lib` alias in this folder.

examples/framework-sveltekit/src/lib/inngest/client.ts

@@ -0,0 +1,4 @@
+import { Inngest } from 'inngest';
+import { schemas } from './types';
+
+export const inngest = new Inngest({ id: 'my-sveltekit-app', schemas });

examples/framework-sveltekit/src/lib/inngest/helloWorld.ts

@@ -0,0 +1,11 @@
+import { inngest } from './client';
+
+export default inngest.createFunction(
+	{ id: 'hello-world' },
+	{ event: 'demo/event.sent' },
+	({ event, step }) => {
+		return {
+			message: `Hello ${event.name}!`
+		};
+	}
+);

examples/framework-sveltekit/src/lib/inngest/index.ts

@@ -0,0 +1,5 @@
+import helloWorld from './helloWorld';
+
+export const functions = [helloWorld];
+
+export { inngest } from './client';

examples/framework-sveltekit/src/lib/inngest/types.ts

@@ -0,0 +1,10 @@
+import { EventSchemas } from 'inngest';
+
+type DemoEventSent = {
+	name: 'demo/event.sent';
+	data: {
+		message: string;
+	};
+};
+
+export const schemas = new EventSchemas().fromUnion<DemoEventSent>();

examples/framework-sveltekit/src/routes/+page.svelte

@@ -0,0 +1,2 @@
+<h1>Welcome to SvelteKit</h1>
+<p>Visit <a href="https://kit.svelte.dev">kit.svelte.dev</a> to read the documentation</p>

examples/framework-sveltekit/src/routes/api/inngest/+server.ts

@@ -0,0 +1,4 @@
+import { functions, inngest } from '$lib/inngest';
+import { serve } from 'inngest/sveltekit';
+
+export const { GET, POST, PUT } = serve({ client: inngest, functions });

examples/framework-sveltekit/svelte.config.js

@@ -0,0 +1,18 @@
+import adapter from '@sveltejs/adapter-auto';
+import { vitePreprocess } from '@sveltejs/kit/vite';
+
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+	// Consult https://kit.svelte.dev/docs/integrations#preprocessors
+	// for more information about preprocessors
+	preprocess: vitePreprocess(),
+
+	kit: {
+		// adapter-auto only supports some environments, see https://kit.svelte.dev/docs/adapter-auto for a list.
+		// If your environment is not supported or you settled on a specific environment, switch out the adapter.
+		// See https://kit.svelte.dev/docs/adapters for more information about adapters.
+		adapter: adapter()
+	}
+};
+
+export default config;

examples/framework-sveltekit/tsconfig.json

@@ -0,0 +1,17 @@
+{
+	"extends": "./.svelte-kit/tsconfig.json",
+	"compilerOptions": {
+		"allowJs": true,
+		"checkJs": true,
+		"esModuleInterop": true,
+		"forceConsistentCasingInFileNames": true,
+		"resolveJsonModule": true,
+		"skipLibCheck": true,
+		"sourceMap": true,
+		"strict": true
+	}
+	// Path aliases are handled by https://kit.svelte.dev/docs/configuration#alias
+	//
+	// If you want to overwrite includes/excludes, make sure to copy over the relevant includes/excludes
+	// from the referenced tsconfig.json - TypeScript does not merge them in
+}

examples/framework-sveltekit/vite.config.ts

@@ -0,0 +1,9 @@
+import { sveltekit } from '@sveltejs/kit/vite';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+	plugins: [sveltekit()],
+	test: {
+		include: ['src/**/*.{test,spec}.{js,ts}']
+	}
+});

packages/inngest/package.json

@@ -12,6 +12,7 @@
     "pb:version": "genversion --semi --double --es6 ./src/version.ts",
     "build": "pnpm run clean && tsc --project tsconfig.build.json",
     "test": "jest --silent --logHeapUsage --maxWorkers=8 --coverage --ci",
+    "itest": "tsx scripts/integrationTestRunner.ts",
     "test:examples": "jest --logHeapUsage --maxWorkers=8 --testMatch \"**/test/functions/**/*.test.ts\" --ci --verbose",
     "test:types": "tsc --noEmit --project tsconfig.types.json --listFiles",
     "clean": "rm -rf ./dist",
@@ -89,6 +90,11 @@
       "import": "./remix.js",
       "types": "./remix.d.ts"
     },
+    "./sveltekit": {
+      "require": "./sveltekit.js",
+      "import": "./sveltekit.js",
+      "types": "./sveltekit.d.ts"
+    },
     "./deno/fresh": {
       "require": "./deno/fresh.js",
       "import": "./deno/fresh.js",
@@ -135,6 +141,7 @@
     "@inngest/eslint-plugin-internal": "workspace:^",
     "@jest/globals": "^29.5.0",
     "@microsoft/api-extractor": "^7.33.7",
+    "@sveltejs/kit": "^1.27.3",
     "@total-typescript/shoehorn": "^0.1.1",
     "@types/aws-lambda": "^8.10.108",
     "@types/debug": "^4.1.8",