@owlmeans/client-entrypoint 0.1.7 → 0.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -75,3 +75,20 @@ Extracts only the keys present in the AJV schema from `obj`.
|
|
|
75
75
|
- [`@owlmeans/entrypoint`](../entrypoint) — `CommonEntrypoint` base that gets elevated
|
|
76
76
|
- [`@owlmeans/client`](../client) — `useNavigate` uses `ClientEntrypoint.call()`
|
|
77
77
|
- [`@owlmeans/server-app`](../server-app) — re-exports `elevate` as `celevate`
|
|
78
|
+
|
|
79
|
+
<!-- owlmeans:agent-guidance:start -->
|
|
80
|
+
## Agent guidance
|
|
81
|
+
|
|
82
|
+
This package ships embedded Claude Code skills and GitHub Copilot instructions under
|
|
83
|
+
`agent-meta/`. After installing your `@owlmeans/*` packages, run the OwlMeans
|
|
84
|
+
agent-skills installer to place them into your project's native locations
|
|
85
|
+
(`.claude/skills/` and `.github/instructions/`):
|
|
86
|
+
|
|
87
|
+
```sh
|
|
88
|
+
npx @owlmeans/agent-skills
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
The embedded files are version-matched to this package release. Do not edit them
|
|
92
|
+
directly — they are regenerated on each publish. To contribute guidance edits,
|
|
93
|
+
open a PR against the source monorepo.
|
|
94
|
+
<!-- owlmeans:agent-guidance:end -->
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "How to use @owlmeans/client-entrypoint — client-side entrypoint helpers extending @owlmeans/entrypoint with React component attachment and call helpers. Also covers the deprecated @owlmeans/client-module reexport shim."
|
|
3
|
+
applyTo: "**/*.ts, **/*.tsx"
|
|
4
|
+
---
|
|
5
|
+
<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
|
|
6
|
+
|
|
7
|
+
# @owlmeans/client-entrypoint
|
|
8
|
+
|
|
9
|
+
**Layer:** Client
|
|
10
|
+
**Install:** `"@owlmeans/client-entrypoint": "^0.1.9"` in `dependencies`
|
|
11
|
+
|
|
12
|
+
## Key Exports
|
|
13
|
+
|
|
14
|
+
| Export | Description |
|
|
15
|
+
|--------|-------------|
|
|
16
|
+
| `ClientEntrypoint<T>` | Client entrypoint interface |
|
|
17
|
+
| `EntrypointCall` / `EntrypointFilter` | Typed call and validation helpers |
|
|
18
|
+
| Entrypoint helpers | Build client entrypoints; resolve callable references |
|
|
19
|
+
|
|
20
|
+
## Subpath Exports
|
|
21
|
+
|
|
22
|
+
- `./utils`
|
|
23
|
+
|
|
24
|
+
## Usage
|
|
25
|
+
|
|
26
|
+
```typescript
|
|
27
|
+
import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## URL Generation via Entrypoint Call
|
|
31
|
+
|
|
32
|
+
Entrypoints with a `handler` (React component) use `urlCall` internally — calling `.call()` returns a URL string, not an API result. Use `{ full: true }` to get a fully-qualified URL with protocol and host via `makeSecurityHelper`:
|
|
33
|
+
|
|
34
|
+
```typescript
|
|
35
|
+
import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
|
|
36
|
+
import { HOME } from '@owlmeans/context'
|
|
37
|
+
|
|
38
|
+
// Get the full URL for the HOME entrypoint
|
|
39
|
+
const [url] = await context.entrypoint<ClientEntrypoint<string>>(HOME).call({ full: true }) ?? []
|
|
40
|
+
|
|
41
|
+
// With route params
|
|
42
|
+
const [authUrl] = await context.entrypoint<ClientEntrypoint<string>>(CAUTHEN_AUTHEN_TYPED).call({
|
|
43
|
+
full: true, params: { type: 'google' }
|
|
44
|
+
}) ?? []
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
This is the preferred pattern for building redirect URIs, OAuth callback URLs, and navigation targets instead of manual `window.location` concatenation.
|
|
48
|
+
|
|
49
|
+
## Depends On
|
|
50
|
+
|
|
51
|
+
- `@owlmeans/entrypoint`, `@owlmeans/client-route`, `@owlmeans/client-context`
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"package": "@owlmeans/client-entrypoint",
|
|
4
|
+
"version": "0.1.9",
|
|
5
|
+
"generatedAt": "2026-06-14T13:34:06.128Z",
|
|
6
|
+
"canonicalRepo": "https://github.com/owlmeans/common",
|
|
7
|
+
"entries": [
|
|
8
|
+
{
|
|
9
|
+
"kind": "skill",
|
|
10
|
+
"name": "client-entrypoint",
|
|
11
|
+
"category": "package-specific",
|
|
12
|
+
"file": "skills/client-entrypoint/SKILL.md",
|
|
13
|
+
"canonicalPath": ".claude/skills/client-entrypoint/SKILL.md"
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
"kind": "instruction",
|
|
17
|
+
"name": "client-entrypoint",
|
|
18
|
+
"category": "package-specific",
|
|
19
|
+
"file": "instructions/client-entrypoint.instructions.md",
|
|
20
|
+
"canonicalPath": ".github/instructions/client-entrypoint.instructions.md"
|
|
21
|
+
}
|
|
22
|
+
]
|
|
23
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: client-entrypoint
|
|
3
|
+
description: How to use @owlmeans/client-entrypoint — client-side entrypoint helpers extending @owlmeans/entrypoint with React component attachment and call helpers. Auto-invoked when importing client entrypoint helpers. Also covers the deprecated @owlmeans/client-module reexport shim.
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
|
|
7
|
+
|
|
8
|
+
# @owlmeans/client-entrypoint
|
|
9
|
+
|
|
10
|
+
**Layer:** Client
|
|
11
|
+
**Install:** `"@owlmeans/client-entrypoint": "^0.1.9"` in `dependencies`
|
|
12
|
+
|
|
13
|
+
## Key Exports
|
|
14
|
+
|
|
15
|
+
| Export | Description |
|
|
16
|
+
|--------|-------------|
|
|
17
|
+
| `ClientEntrypoint<T>` types | Client entrypoint interface (handler component + call helpers) |
|
|
18
|
+
| `EntrypointCall` / `EntrypointFilter` | Typed call and validation helpers |
|
|
19
|
+
| `EntrypointRef` / `RefedEntrypointHandler` | Handler reference pattern |
|
|
20
|
+
| Entrypoint helpers | Build client entrypoints; resolve callable references |
|
|
21
|
+
|
|
22
|
+
## Subpath Exports
|
|
23
|
+
|
|
24
|
+
- `./utils`
|
|
25
|
+
|
|
26
|
+
## Usage
|
|
27
|
+
|
|
28
|
+
Most app code uses `elevate()` from `@owlmeans/web-client` (which builds on this). Use this directly only for cross-platform entrypoint helpers.
|
|
29
|
+
|
|
30
|
+
```typescript
|
|
31
|
+
import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## URL Generation via Entrypoint Call
|
|
35
|
+
|
|
36
|
+
Entrypoints with a `handler` (React component) use `urlCall` internally — calling `.call()` returns a URL string. Use `{ full: true }` to get a fully-qualified URL via `makeSecurityHelper`:
|
|
37
|
+
|
|
38
|
+
```typescript
|
|
39
|
+
import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
|
|
40
|
+
import { HOME } from '@owlmeans/context'
|
|
41
|
+
|
|
42
|
+
const [url] = await context.entrypoint<ClientEntrypoint<string>>(HOME).call({ full: true }) ?? []
|
|
43
|
+
// Returns e.g. "https://app.example.com/"
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
This is the preferred pattern for redirect URIs and navigation targets instead of manual `window.location` concatenation.
|
|
47
|
+
|
|
48
|
+
## Depends On
|
|
49
|
+
|
|
50
|
+
- `@owlmeans/entrypoint`, `@owlmeans/client-route`, `@owlmeans/client-context`
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@owlmeans/client-entrypoint",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.9",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"scripts": {
|
|
@@ -28,15 +28,15 @@
|
|
|
28
28
|
}
|
|
29
29
|
},
|
|
30
30
|
"dependencies": {
|
|
31
|
-
"@owlmeans/api": "^0.1.
|
|
32
|
-
"@owlmeans/client-config": "^0.1.
|
|
33
|
-
"@owlmeans/client-context": "^0.1.
|
|
34
|
-
"@owlmeans/client-route": "^0.1.
|
|
35
|
-
"@owlmeans/config": "^0.1.
|
|
36
|
-
"@owlmeans/context": "^0.1.
|
|
37
|
-
"@owlmeans/entrypoint": "^0.1.
|
|
38
|
-
"@owlmeans/error": "^0.1.
|
|
39
|
-
"@owlmeans/route": "^0.1.
|
|
31
|
+
"@owlmeans/api": "^0.1.9",
|
|
32
|
+
"@owlmeans/client-config": "^0.1.9",
|
|
33
|
+
"@owlmeans/client-context": "^0.1.9",
|
|
34
|
+
"@owlmeans/client-route": "^0.1.9",
|
|
35
|
+
"@owlmeans/config": "^0.1.9",
|
|
36
|
+
"@owlmeans/context": "^0.1.9",
|
|
37
|
+
"@owlmeans/entrypoint": "^0.1.9",
|
|
38
|
+
"@owlmeans/error": "^0.1.9",
|
|
39
|
+
"@owlmeans/route": "^0.1.9",
|
|
40
40
|
"ajv-formats": "^3.0.1",
|
|
41
41
|
"qs": "^6.13.0"
|
|
42
42
|
},
|