@refkit/provider-brave 0.1.0 → 0.1.1

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.
Files changed (2) hide show
  1. package/README.md +21 -0
  2. package/package.json +14 -3
package/README.md ADDED
@@ -0,0 +1,21 @@
1
+ # @refkit/provider-brave
2
+
3
+ Open-web image **discovery** via the Brave Search API — breadth, with honest license gating — a provider satellite for **refkit** (use with [`@refkit/core`](https://www.npmjs.com/package/@refkit/core)).
4
+
5
+ - **Source:** Brave Search image API ([brave.com/search/api](https://brave.com/search/api/))
6
+ - **Auth:** API key — `brave({ token: '…' })`
7
+ - **Modality:** image (open-web)
8
+ - **License:** `unknown` → `needs-review` (a discovery source; results are never auto-allowed)
9
+
10
+ ## Usage
11
+
12
+ ```ts
13
+ import { createRefkit } from '@refkit/core'
14
+ import { brave } from '@refkit/provider-brave'
15
+
16
+ const refkit = createRefkit({ providers: [brave({ token: process.env.BRAVE_TOKEN! })] })
17
+ const refs = await refkit.search({ query: 'cyberpunk alley', modalities: ['image'] })
18
+ // every result carries source + license + attribution + canonicalUrl
19
+ ```
20
+
21
+ Use discovery results for inspiration / internal moodboards. Because their license is `unknown`, `refkit.evaluateUse(ref, 'commercial-product')` returns `needs-review` — verify the source's terms before any commercial or generation use, or pass `gateFor: 'commercial-product'` to drop them. See [`@refkit/core`](https://www.npmjs.com/package/@refkit/core) for the full API.
package/package.json CHANGED
@@ -1,9 +1,20 @@
1
1
  {
2
2
  "name": "@refkit/provider-brave",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Brave Search web-discovery provider satellite for refkit — open-web image breadth, license:unknown (use-gated to needs-review).",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
7
+ "keywords": [
8
+ "refkit",
9
+ "reference-retrieval",
10
+ "license",
11
+ "attribution",
12
+ "refkit-provider",
13
+ "brave",
14
+ "web-search",
15
+ "image-search",
16
+ "discovery"
17
+ ],
7
18
  "main": "./dist/index.js",
8
19
  "types": "./dist/index.d.ts",
9
20
  "exports": {
@@ -13,10 +24,10 @@
13
24
  }
14
25
  },
15
26
  "dependencies": {
16
- "@refkit/core": "0.1.0"
27
+ "@refkit/core": "0.2.0"
17
28
  },
18
29
  "devDependencies": {
19
- "@refkit/provider-openverse": "0.1.0"
30
+ "@refkit/provider-openverse": "0.1.1"
20
31
  },
21
32
  "files": [
22
33
  "dist",