@owlmeans/server-entrypoint 0.1.7 → 0.1.9

package/README.md

@@ -66,3 +66,20 @@ A handler factory: `(ref: { ref?: { ctx?: Context } }) => EntrypointHandler`.
 - [`@owlmeans/entrypoint`](../entrypoint) — `CommonEntrypoint` base that gets elevated
 - [`@owlmeans/server-api`](../server-api) — handler wrappers (`handleBody`, etc.) used with `elevate`
 - [`@owlmeans/server-app`](../server-app) — re-exports `elevate`, `entrypoint`, `guard`
+
+<!-- owlmeans:agent-guidance:start -->
+## Agent guidance
+
+This package ships embedded Claude Code skills and GitHub Copilot instructions under
+`agent-meta/`. After installing your `@owlmeans/*` packages, run the OwlMeans
+agent-skills installer to place them into your project's native locations
+(`.claude/skills/` and `.github/instructions/`):
+
+```sh
+npx @owlmeans/agent-skills
+```
+
+The embedded files are version-matched to this package release. Do not edit them
+directly — they are regenerated on each publish. To contribute guidance edits,
+open a PR against the source monorepo.
+<!-- owlmeans:agent-guidance:end -->

package/agent-meta/instructions/server-entrypoint.instructions.md

@@ -0,0 +1,39 @@
+---
+description: "How to use @owlmeans/server-entrypoint — server-side entrypoint helpers extending @owlmeans/entrypoint with handler attachment and request lifecycle hooks. Also covers the deprecated @owlmeans/server-module reexport shim."
+applyTo: "**/*.ts, **/*.tsx"
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/server-entrypoint
+
+**Layer:** Server
+**Install:** `"@owlmeans/server-entrypoint": "^0.1.9"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `ServerEntrypoint` types | Server entrypoint interface |
+| `EntrypointOptions` | Elevation options (handler, fixer, intermediate) |
+| Helpers | Attach handlers, hook lifecycle |
+
+## Usage
+
+```typescript
+import type { ServerEntrypoint } from '@owlmeans/server-entrypoint'
+// Most code uses elevate() from @owlmeans/server-app instead
+```
+
+## Cross-Service URL Generation
+
+Server entrypoints that need to produce URLs for other services (e.g., OAuth redirect URIs, callback URLs) should use `makeSecurityHelper` from `@owlmeans/config`:
+
+```typescript
+import { makeSecurityHelper } from '@owlmeans/config'
+const helper = makeSecurityHelper<Config, Context>(ctx)
+const callbackUrl = helper.makeUrl(route, '/callback')
+```
+
+## Depends On
+
+- `@owlmeans/entrypoint`, `@owlmeans/server-route`, `@owlmeans/server-context`

package/agent-meta/manifest.json

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "package": "@owlmeans/server-entrypoint",
+  "version": "0.1.9",
+  "generatedAt": "2026-06-14T13:34:06.133Z",
+  "canonicalRepo": "https://github.com/owlmeans/common",
+  "entries": [
+    {
+      "kind": "skill",
+      "name": "server-entrypoint",
+      "category": "package-specific",
+      "file": "skills/server-entrypoint/SKILL.md",
+      "canonicalPath": ".claude/skills/server-entrypoint/SKILL.md"
+    },
+    {
+      "kind": "instruction",
+      "name": "server-entrypoint",
+      "category": "package-specific",
+      "file": "instructions/server-entrypoint.instructions.md",
+      "canonicalPath": ".github/instructions/server-entrypoint.instructions.md"
+    }
+  ]
+}

package/agent-meta/skills/server-entrypoint/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: server-entrypoint
+description: How to use @owlmeans/server-entrypoint — server-side entrypoint helpers extending @owlmeans/entrypoint with handler attachment, request lifecycle hooks. Auto-invoked when importing server-entrypoint types. Also covers the deprecated @owlmeans/server-module reexport shim.
+user-invocable: false
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/server-entrypoint
+
+**Layer:** Server
+**Install:** `"@owlmeans/server-entrypoint": "^0.1.9"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `ServerEntrypoint` types | Server entrypoint interface (handler + lifecycle) |
+| `EntrypointOptions` | Options for elevating with handler, fixer, intermediate |
+| `EntrypointRef` / `RefedEntrypointHandler` | Handler reference pattern |
+| Helpers | Attach handlers, hook into request lifecycle |
+
+## Usage
+
+Most app code uses `elevate()` from `@owlmeans/server-app` (which builds on this package). Import directly only when implementing custom entrypoint helpers.
+
+```typescript
+import type { ServerEntrypoint } from '@owlmeans/server-entrypoint'
+```
+
+## Cross-Service URL Generation
+
+Use `makeSecurityHelper` from `@owlmeans/config` to build URLs pointing at other services (OAuth redirect URIs, webhook callbacks, etc.):
+
+```typescript
+import { makeSecurityHelper } from '@owlmeans/config'
+const helper = makeSecurityHelper<Config, Context>(ctx)
+const url = helper.makeUrl(route, '/callback')
+```
+
+## Depends On
+
+- `@owlmeans/entrypoint`, `@owlmeans/server-route`, `@owlmeans/server-context`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/server-entrypoint",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,10 +21,10 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.7",
-    "@owlmeans/entrypoint": "^0.1.7",
-    "@owlmeans/route": "^0.1.7",
-    "@owlmeans/server-route": "^0.1.7"
+    "@owlmeans/context": "^0.1.9",
+    "@owlmeans/entrypoint": "^0.1.9",
+    "@owlmeans/route": "^0.1.9",
+    "@owlmeans/server-route": "^0.1.9"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",