@theholocron/holocron-plugin-axiom 5.0.0-alpha.422 → 5.0.0-alpha.423
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 +9 -9
- package/dist/index.d.mts +1 -1
- package/dist/index.mjs +5 -5
- package/package.json +10 -10
package/README.md
CHANGED
|
@@ -4,12 +4,12 @@
|
|
|
4
4
|
|
|
5
5
|
Axiom plugin for [Holocron](../cli). Implements the `logs` capability
|
|
6
6
|
against [Axiom's REST API](https://axiom.co/docs/restapi/introduction),
|
|
7
|
-
plus exports `verifyToken` + `AUTH_HINT` for use by `holocron
|
|
7
|
+
plus exports `verifyToken` + `AUTH_HINT` for use by `holocron check token`.
|
|
8
8
|
|
|
9
9
|
> This plugin does **not** ship log lines. `@theholocron/observability/logger`'s
|
|
10
10
|
> Axiom transport reads `HOLOCRON_AXIOM_TOKEN` / `HOLOCRON_AXIOM_DATASET`
|
|
11
11
|
> directly at startup. The `logs` capability exists only for the
|
|
12
|
-
> management surface — `holocron
|
|
12
|
+
> management surface — `holocron setup` provisions the aggregation
|
|
13
13
|
> datasets and `holocron doctor` checks connectivity.
|
|
14
14
|
|
|
15
15
|
## Install
|
|
@@ -26,14 +26,14 @@ Token resolution order:
|
|
|
26
26
|
2. `HOLOCRON_AXIOM_TOKEN` env var (preferred — explicit intent)
|
|
27
27
|
3. `AXIOM_TOKEN` env var (Axiom-native, works in CI)
|
|
28
28
|
4. Keyring `axiom.<org>` — tried first when an org is active via `--org`, `HOLOCRON_ORG`, or `org` in `holocron.config.ts`
|
|
29
|
-
5. Keyring `axiom` — unnamespaced fallback; set via `holocron
|
|
29
|
+
5. Keyring `axiom` — unnamespaced fallback; set via `holocron new token axiom <token>`
|
|
30
30
|
6. `AuthError` naming both env vars + the auth hint
|
|
31
31
|
|
|
32
32
|
Generate an API token at **app.axiom.co/settings/api-tokens** with
|
|
33
33
|
permission to read and create datasets.
|
|
34
34
|
|
|
35
35
|
```bash
|
|
36
|
-
holocron
|
|
36
|
+
holocron new token axiom.theholocron <TOKEN>
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
**CI**: the keyring is unavailable in headless containers — expose the
|
|
@@ -49,7 +49,7 @@ token as `HOLOCRON_AXIOM_TOKEN` (or `AXIOM_TOKEN`) in the workflow env.
|
|
|
49
49
|
}
|
|
50
50
|
```
|
|
51
51
|
|
|
52
|
-
No options are required. `holocron
|
|
52
|
+
No options are required. `holocron setup` provisions the CLI's dataset (`holocron`)
|
|
53
53
|
named by `HOLOCRON_AXIOM_DATASET` / `AXIOM_DATASET`; every environment of the CLI ships to
|
|
54
54
|
it and is told apart by the `env` field on each line. `holocron doctor` checks
|
|
55
55
|
the same dataset. An explicit `logs: ["axiom", { "dataset": "my-dataset" }]`
|
|
@@ -70,7 +70,7 @@ synced from 1Password. Leave the token unset locally to skip Axiom entirely.
|
|
|
70
70
|
|
|
71
71
|
Plugin-level exports (not capability methods, per the auth-bootstrap convention):
|
|
72
72
|
|
|
73
|
-
| Export | Purpose
|
|
74
|
-
| ------------- |
|
|
75
|
-
| `verifyToken` | `GET /v2/user` — returns `{ ok: true, subject: "user @ …" }` or `{ ok: false, message }`.
|
|
76
|
-
| `AUTH_HINT` | One-line hint printed by `holocron
|
|
73
|
+
| Export | Purpose |
|
|
74
|
+
| ------------- | -------------------------------------------------------------------------------------------- |
|
|
75
|
+
| `verifyToken` | `GET /v2/user` — returns `{ ok: true, subject: "user @ …" }` or `{ ok: false, message }`. |
|
|
76
|
+
| `AUTH_HINT` | One-line hint printed by `holocron new token` when no token is supplied or the token is bad. |
|
package/dist/index.d.mts
CHANGED
|
@@ -89,7 +89,7 @@ export declare function createPlugin(options: AxiomPluginOptions): {
|
|
|
89
89
|
};
|
|
90
90
|
};
|
|
91
91
|
/**
|
|
92
|
-
* One-line hint shown by `holocron
|
|
92
|
+
* One-line hint shown by `holocron new token axiom` when no token is
|
|
93
93
|
* supplied or when the supplied token is rejected.
|
|
94
94
|
*/
|
|
95
95
|
export declare const AUTH_HINT: string;
|
package/dist/index.mjs
CHANGED
|
@@ -8,7 +8,7 @@ const resolveToken = createResolveToken({
|
|
|
8
8
|
envName: "HOLOCRON_AXIOM_TOKEN",
|
|
9
9
|
vendorEnvName: "AXIOM_TOKEN",
|
|
10
10
|
keyringService: "axiom",
|
|
11
|
-
errorMessage: "no Axiom token found. Pass --token <TOKEN>, set HOLOCRON_AXIOM_TOKEN / AXIOM_TOKEN, or run: holocron
|
|
11
|
+
errorMessage: "no Axiom token found. Pass --token <TOKEN>, set HOLOCRON_AXIOM_TOKEN / AXIOM_TOKEN, or run: holocron new token axiom <TOKEN>"
|
|
12
12
|
});
|
|
13
13
|
/** Every token this plugin takes, for `holocron doctor tokens`. */
|
|
14
14
|
const tokens = [resolveToken.token];
|
|
@@ -90,8 +90,8 @@ var AxiomLogs = class {
|
|
|
90
90
|
};
|
|
91
91
|
// src/verify-token.ts
|
|
92
92
|
/**
|
|
93
|
-
* `verifyToken` — plugin-level export used by `holocron
|
|
94
|
-
* + `holocron
|
|
93
|
+
* `verifyToken` — plugin-level export used by `holocron new token axiom`
|
|
94
|
+
* + `holocron check token`. Hits `GET /v2/user` and translates the
|
|
95
95
|
* response into the normalized `VerifyTokenResult` shape.
|
|
96
96
|
*
|
|
97
97
|
* Kept as a standalone function (not a capability method) so the auth
|
|
@@ -183,8 +183,8 @@ function createPlugin(options) {
|
|
|
183
183
|
};
|
|
184
184
|
}
|
|
185
185
|
/**
|
|
186
|
-
* One-line hint shown by `holocron
|
|
186
|
+
* One-line hint shown by `holocron new token axiom` when no token is
|
|
187
187
|
* supplied or when the supplied token is rejected.
|
|
188
188
|
*/
|
|
189
|
-
const AUTH_HINT = "generate an Axiom API token at https://app.axiom.co/settings/api-tokens with dataset read + create permissions, then run: holocron
|
|
189
|
+
const AUTH_HINT = "generate an Axiom API token at https://app.axiom.co/settings/api-tokens with dataset read + create permissions, then run: holocron new token axiom <TOKEN>";
|
|
190
190
|
export { AUTH_HINT, AuthError, AxiomLogs, createAxiomClient, createContext, createPlugin, logs, resolveToken, tokens, verifyToken };
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@theholocron/holocron-plugin-axiom",
|
|
3
|
-
"version": "5.0.0-alpha.
|
|
3
|
+
"version": "5.0.0-alpha.423",
|
|
4
4
|
"description": "Holocron plugin for Axiom. Implements the logs capability against Axiom's REST API — dataset provisioning and connectivity checks, plus verifyToken + AUTH_HINT for `holocron auth`.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"axiom",
|
|
@@ -43,19 +43,19 @@
|
|
|
43
43
|
"tsx": "4.23.15",
|
|
44
44
|
"typescript": "^5.9.3",
|
|
45
45
|
"vitest": "^5.1.0",
|
|
46
|
-
"@theholocron/
|
|
47
|
-
"@theholocron/
|
|
48
|
-
"@theholocron/
|
|
49
|
-
"@theholocron/
|
|
50
|
-
"@theholocron/
|
|
51
|
-
"@theholocron/
|
|
52
|
-
"@theholocron/tsdown-config": "^8.9.0-alpha.
|
|
53
|
-
"@theholocron/
|
|
46
|
+
"@theholocron/cli": "5.0.0-alpha.423",
|
|
47
|
+
"@theholocron/axiom-client": "^1.58.0-alpha.29",
|
|
48
|
+
"@theholocron/eslint-config": "^8.9.0-alpha.17",
|
|
49
|
+
"@theholocron/http-client": "^1.58.0-alpha.29",
|
|
50
|
+
"@theholocron/tsconfig": "^8.9.0-alpha.17",
|
|
51
|
+
"@theholocron/vitest-config": "^8.9.0-alpha.17",
|
|
52
|
+
"@theholocron/tsdown-config": "^8.9.0-alpha.17",
|
|
53
|
+
"@theholocron/misc-utils": "^1.17.0-alpha.4"
|
|
54
54
|
},
|
|
55
55
|
"peerDependencies": {
|
|
56
56
|
"@theholocron/axiom-client": "^1.43.1",
|
|
57
57
|
"@theholocron/misc-utils": "^1.16.0",
|
|
58
|
-
"@theholocron/cli": "5.0.0-alpha.
|
|
58
|
+
"@theholocron/cli": "5.0.0-alpha.423"
|
|
59
59
|
},
|
|
60
60
|
"engines": {
|
|
61
61
|
"node": ">=22"
|