@brigadasos/nadeshiko-sdk 1.4.3-dev.5fa35ac → 1.4.3-dev.824dc71

package/README.md

@@ -14,14 +14,16 @@ Install the internal build (includes internal endpoints) via the `internal` dist
 bun add @brigadasos/nadeshiko-sdk@internal
 ```
 
-## Use the public SDK
+## Authentication
 
-The client sends your API key as `Authorization: Bearer <apiKey>`.
+### API key (server-to-server)
+
+Use an API key for endpoints that don't require a user session. The key is sent as `Authorization: Bearer <apiKey>`.
 
 ```typescript
-import { createClient, searchSegments } from '@brigadasos/nadeshiko-sdk';
+import { createNadeshikoClient, searchSegments } from '@brigadasos/nadeshiko-sdk';
 
-const client = createClient({
+const client = createNadeshikoClient({
   apiKey: process.env.NADESHIKO_API_KEY!,
   baseUrl: 'PRODUCTION',
 });
@@ -30,22 +32,44 @@ const result = await searchSegments({
   client,
   body: { query: '彼女' },
 });
+```
 
-if (result.error) {
-  console.error(result.error.code, result.error.detail);
-} else {
-  console.log(result.data);
+### Session token (user-authenticated endpoints)
+
+Endpoints under `/v1/user/*` and `/v1/collections/*` require a user session. Pass a `sessionToken` getter that returns the value of the `nadeshiko.session_token` cookie — called fresh on every request.
+
+**Nuxt / Nitro server routes:**
+
+```typescript
+// server/utils/nadeshiko.ts
+import { createNadeshikoClient } from '@brigadasos/nadeshiko-sdk';
+import type { H3Event } from 'h3';
+
+export function useNadeshikoClient(event: H3Event) {
+  return createNadeshikoClient({
+    sessionToken: () => getCookie(event, 'nadeshiko.session_token'),
+  });
 }
 ```
 
+```typescript
+// server/api/preferences.get.ts
+export default defineEventHandler(async (event) => {
+  const client = useNadeshikoClient(event);
+  return client.getUserPreferences();
+});
+```
+
+**Browser (no configuration needed):** the default `sessionToken` getter reads `nadeshiko.session_token` from `document.cookie` automatically.
+
 ### Error handling
 
 Every response returns a discriminated union with either `data` or `error`. The `error` object follows the [RFC 7807](https://tools.ietf.org/html/rfc7807) Problem Details format, so you always get a machine-readable `code` and a human-readable `detail`.
 
 ```typescript
-import { createClient, searchSegments } from '@brigadasos/nadeshiko-sdk';
+import { createNadeshikoClient, searchSegments } from '@brigadasos/nadeshiko-sdk';
 
-const client = createClient({
+const client = createNadeshikoClient({
   apiKey: process.env.NADESHIKO_API_KEY!,
   baseUrl: 'PRODUCTION',
 });

package/dist/index.cjs

@@ -96,9 +96,9 @@ __export(exports_dev, {
   createMedia: () => createMedia,
   createEpisode: () => createEpisode,
   createCollection: () => createCollection,
-  createClient: () => createClient2,
   createAdminReviewAllowlistEntry: () => createAdminReviewAllowlistEntry,
   client: () => client,
+  autocompleteMedia: () => autocompleteMedia,
   admin: () => exports_admin_gen,
   addSegmentToCollection: () => addSegmentToCollection,
   addMediaToSeries: () => addMediaToSeries
@@ -961,6 +961,11 @@ var createMedia = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var autocompleteMedia = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/v1/media/autocomplete",
+  ...options
+});
 var deleteMedia = (options) => (options.client ?? client).delete({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/v1/media/{id}",
@@ -1437,13 +1442,20 @@ var environments = {
   DEVELOPMENT: "https://api.dev.brigadasos.xyz/api",
   PRODUCTION: "https://api.brigadasos.xyz/api"
 };
+var defaultSessionTokenGetter = () => {
+  if (typeof document === "undefined")
+    return;
+  const match = document.cookie.match(/(?:^|;\s*)nadeshiko\.session_token=([^;]*)/);
+  return match ? decodeURIComponent(match[1]) : undefined;
+};
 function createNadeshikoClient(config) {
   const baseUrl = config.baseUrl ? config.baseUrl in environments ? environments[config.baseUrl] : config.baseUrl : environments.PRODUCTION;
+  const getSessionToken = config.sessionToken ?? defaultSessionTokenGetter;
   const clientInstance = createClient(createConfig({
     baseUrl,
     auth: (auth) => {
       if (auth.in === "cookie") {
-        return config.sessionToken;
+        return getSessionToken();
       }
       return config.apiKey;
     }
@@ -1490,6 +1502,7 @@ function createNadeshikoClient(config) {
     createAdminReviewAllowlistEntry: (options) => createAdminReviewAllowlistEntry({ ...options, client: clientInstance }),
     deleteAdminReviewAllowlistEntry: (options) => deleteAdminReviewAllowlistEntry({ ...options, client: clientInstance }),
     createMedia: (options) => createMedia({ ...options, client: clientInstance }),
+    autocompleteMedia: (options) => autocompleteMedia({ ...options, client: clientInstance }),
     updateMedia: (options) => updateMedia({ ...options, client: clientInstance }),
     deleteMedia: (options) => deleteMedia({ ...options, client: clientInstance }),
     createEpisode: (options) => createEpisode({ ...options, client: clientInstance }),
@@ -1519,7 +1532,6 @@ function createNadeshikoClient(config) {
     getAdminHealth: (options) => getAdminHealth({ ...options, client: clientInstance })
   };
 }
-var createClient2 = createNadeshikoClient;
 // generated/dev/internal/media.gen.ts
 var exports_media_gen = {};
 __export(exports_media_gen, {
@@ -1538,6 +1550,7 @@ __export(exports_media_gen, {
   createSegment: () => createSegment,
   createMedia: () => createMedia,
   createEpisode: () => createEpisode,
+  autocompleteMedia: () => autocompleteMedia,
   addMediaToSeries: () => addMediaToSeries
 });
 // generated/dev/internal/user.gen.ts
@@ -1561,5 +1574,5 @@ __export(exports_admin_gen, {
   getAdminDashboard: () => getAdminDashboard
 });
 
-//# debugId=6D298160C99A5F9A64756E2164756E21
+//# debugId=4B0EFE7CA1477FC664756E2164756E21
 //# sourceMappingURL=index.js.map