@brigadasos/nadeshiko-sdk 1.4.2-dev.a13aba0 → 1.4.3-dev.09dcbc3

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

@@ -30,10 +30,10 @@ var __export = (target, all) => {
 var exports_dev = {};
 __export(exports_dev, {
   user: () => exports_user_gen,
+  updateUserPreferences: () => updateUserPreferences,
   updateSeriesMedia: () => updateSeriesMedia,
   updateSeries: () => updateSeries,
   updateSegment: () => updateSegment,
-  updatePreferences: () => updatePreferences,
   updateMedia: () => updateMedia,
   updateEpisode: () => updateEpisode,
   updateCollectionSegment: () => updateCollectionSegment,
@@ -49,11 +49,12 @@ __export(exports_dev, {
   removeMediaFromSeries: () => removeMediaFromSeries,
   purgeAdminQueueFailed: () => purgeAdminQueueFailed,
   media: () => exports_media_gen,
+  listUserReports: () => listUserReports,
+  listUserLabs: () => listUserLabs,
+  listUserActivity: () => listUserActivity,
   listSeries: () => listSeries,
   listSegments: () => listSegments,
-  listReports: () => listReports,
   listMedia: () => listMedia,
-  listLabs: () => listLabs,
   listEpisodes: () => listEpisodes,
   listCollections: () => listCollections,
   listAdminReviewRuns: () => listAdminReviewRuns,
@@ -62,15 +63,16 @@ __export(exports_dev, {
   listAdminReports: () => listAdminReports,
   listAdminQueueStats: () => listAdminQueueStats,
   listAdminQueueFailed: () => listAdminQueueFailed,
-  listActivity: () => listActivity,
+  getUserQuota: () => getUserQuota,
+  getUserPreferences: () => getUserPreferences,
+  getUserActivityStats: () => getUserActivityStats,
+  getUserActivityHeatmap: () => getUserActivityHeatmap,
   getSeries: () => getSeries,
   getSeiyuu: () => getSeiyuu,
   getSegmentContext: () => getSegmentContext,
   getSegmentByUuid: () => getSegmentByUuid,
   getSegment: () => getSegment,
   getSearchStats: () => getSearchStats,
-  getQuota: () => getQuota,
-  getPreferences: () => getPreferences,
   getMedia: () => getMedia,
   getEpisode: () => getEpisode,
   getCollection: () => getCollection,
@@ -79,26 +81,24 @@ __export(exports_dev, {
   getAdminQueue: () => getAdminQueue,
   getAdminHealth: () => getAdminHealth,
   getAdminDashboard: () => getAdminDashboard,
-  getActivityStats: () => getActivityStats,
-  getActivityHeatmap: () => getActivityHeatmap,
-  exportData: () => exportData,
+  exportUserData: () => exportUserData,
+  deleteUserActivity: () => deleteUserActivity,
   deleteSeries: () => deleteSeries,
   deleteSegment: () => deleteSegment,
   deleteMedia: () => deleteMedia,
   deleteEpisode: () => deleteEpisode,
   deleteCollection: () => deleteCollection,
   deleteAdminReviewAllowlistEntry: () => deleteAdminReviewAllowlistEntry,
-  deleteActivity: () => deleteActivity,
+  createUserReport: () => createUserReport,
   createSeries: () => createSeries,
   createSegment: () => createSegment,
-  createReport: () => createReport,
   createNadeshikoClient: () => createNadeshikoClient,
   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}",
@@ -1130,7 +1135,7 @@ var getSeiyuu = (options) => (options.client ?? client).get({
   url: "/v1/media/seiyuu/{id}",
   ...options
 });
-var getQuota = (options) => (options?.client ?? client).get({
+var getUserQuota = (options) => (options?.client ?? client).get({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
@@ -1139,7 +1144,7 @@ var getQuota = (options) => (options?.client ?? client).get({
   url: "/v1/user/quota",
   ...options
 });
-var listReports = (options) => (options?.client ?? client).get({
+var listUserReports = (options) => (options?.client ?? client).get({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
@@ -1148,7 +1153,7 @@ var listReports = (options) => (options?.client ?? client).get({
   url: "/v1/user/reports",
   ...options
 });
-var createReport = (options) => (options.client ?? client).post({
+var createUserReport = (options) => (options.client ?? client).post({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
@@ -1161,7 +1166,7 @@ var createReport = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
-var getPreferences = (options) => (options?.client ?? client).get({
+var getUserPreferences = (options) => (options?.client ?? client).get({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
@@ -1170,7 +1175,7 @@ var getPreferences = (options) => (options?.client ?? client).get({
   url: "/v1/user/preferences",
   ...options
 });
-var updatePreferences = (options) => (options.client ?? client).patch({
+var updateUserPreferences = (options) => (options.client ?? client).patch({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
@@ -1183,7 +1188,7 @@ var updatePreferences = (options) => (options.client ?? client).patch({
     ...options.headers
   }
 });
-var deleteActivity = (options) => (options?.client ?? client).delete({
+var deleteUserActivity = (options) => (options?.client ?? client).delete({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
@@ -1192,7 +1197,7 @@ var deleteActivity = (options) => (options?.client ?? client).delete({
   url: "/v1/user/activity",
   ...options
 });
-var listActivity = (options) => (options?.client ?? client).get({
+var listUserActivity = (options) => (options?.client ?? client).get({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
@@ -1201,7 +1206,7 @@ var listActivity = (options) => (options?.client ?? client).get({
   url: "/v1/user/activity",
   ...options
 });
-var getActivityHeatmap = (options) => (options?.client ?? client).get({
+var getUserActivityHeatmap = (options) => (options?.client ?? client).get({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
@@ -1210,7 +1215,7 @@ var getActivityHeatmap = (options) => (options?.client ?? client).get({
   url: "/v1/user/activity/heatmap",
   ...options
 });
-var getActivityStats = (options) => (options?.client ?? client).get({
+var getUserActivityStats = (options) => (options?.client ?? client).get({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
@@ -1219,7 +1224,7 @@ var getActivityStats = (options) => (options?.client ?? client).get({
   url: "/v1/user/activity/stats",
   ...options
 });
-var exportData = (options) => (options?.client ?? client).get({
+var exportUserData = (options) => (options?.client ?? client).get({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
@@ -1228,7 +1233,7 @@ var exportData = (options) => (options?.client ?? client).get({
   url: "/v1/user/export",
   ...options
 });
-var listLabs = (options) => (options?.client ?? client).get({
+var listUserLabs = (options) => (options?.client ?? client).get({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
@@ -1437,11 +1442,23 @@ 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,
-    headers: { Authorization: `Bearer ${config.apiKey}` }
+    auth: (auth) => {
+      if (auth.in === "cookie") {
+        return getSessionToken();
+      }
+      return config.apiKey;
+    }
   }));
   return {
     client: clientInstance,
@@ -1459,7 +1476,7 @@ function createNadeshikoClient(config) {
     getSeries: (options) => getSeries({ ...options, client: clientInstance }),
     getCharacter: (options) => getCharacter({ ...options, client: clientInstance }),
     getSeiyuu: (options) => getSeiyuu({ ...options, client: clientInstance }),
-    getQuota: (options) => getQuota({ ...options, client: clientInstance }),
+    getUserQuota: (options) => getUserQuota({ ...options, client: clientInstance }),
     listCollections: (options) => listCollections({ ...options, client: clientInstance }),
     createCollection: (options) => createCollection({ ...options, client: clientInstance }),
     getCollection: (options) => getCollection({ ...options, client: clientInstance }),
@@ -1485,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 }),
@@ -1500,21 +1518,20 @@ function createNadeshikoClient(config) {
     addMediaToSeries: (options) => addMediaToSeries({ ...options, client: clientInstance }),
     updateSeriesMedia: (options) => updateSeriesMedia({ ...options, client: clientInstance }),
     removeMediaFromSeries: (options) => removeMediaFromSeries({ ...options, client: clientInstance }),
-    createReport: (options) => createReport({ ...options, client: clientInstance }),
-    listReports: (options) => listReports({ ...options, client: clientInstance }),
-    getPreferences: (options) => getPreferences({ ...options, client: clientInstance }),
-    updatePreferences: (options) => updatePreferences({ ...options, client: clientInstance }),
-    listActivity: (options) => listActivity({ ...options, client: clientInstance }),
-    deleteActivity: (options) => deleteActivity({ ...options, client: clientInstance }),
-    getActivityHeatmap: (options) => getActivityHeatmap({ ...options, client: clientInstance }),
-    getActivityStats: (options) => getActivityStats({ ...options, client: clientInstance }),
-    exportData: (options) => exportData({ ...options, client: clientInstance }),
-    listLabs: (options) => listLabs({ ...options, client: clientInstance }),
+    createUserReport: (options) => createUserReport({ ...options, client: clientInstance }),
+    listUserReports: (options) => listUserReports({ ...options, client: clientInstance }),
+    getUserPreferences: (options) => getUserPreferences({ ...options, client: clientInstance }),
+    updateUserPreferences: (options) => updateUserPreferences({ ...options, client: clientInstance }),
+    listUserActivity: (options) => listUserActivity({ ...options, client: clientInstance }),
+    deleteUserActivity: (options) => deleteUserActivity({ ...options, client: clientInstance }),
+    getUserActivityHeatmap: (options) => getUserActivityHeatmap({ ...options, client: clientInstance }),
+    getUserActivityStats: (options) => getUserActivityStats({ ...options, client: clientInstance }),
+    exportUserData: (options) => exportUserData({ ...options, client: clientInstance }),
+    listUserLabs: (options) => listUserLabs({ ...options, client: clientInstance }),
     getAdminDashboard: (options) => getAdminDashboard({ ...options, client: clientInstance }),
     getAdminHealth: (options) => getAdminHealth({ ...options, client: clientInstance })
   };
 }
-var createClient2 = createNadeshikoClient;
 // generated/dev/internal/media.gen.ts
 var exports_media_gen = {};
 __export(exports_media_gen, {
@@ -1533,21 +1550,22 @@ __export(exports_media_gen, {
   createSegment: () => createSegment,
   createMedia: () => createMedia,
   createEpisode: () => createEpisode,
+  autocompleteMedia: () => autocompleteMedia,
   addMediaToSeries: () => addMediaToSeries
 });
 // generated/dev/internal/user.gen.ts
 var exports_user_gen = {};
 __export(exports_user_gen, {
-  updatePreferences: () => updatePreferences,
-  listReports: () => listReports,
-  listLabs: () => listLabs,
-  listActivity: () => listActivity,
-  getPreferences: () => getPreferences,
-  getActivityStats: () => getActivityStats,
-  getActivityHeatmap: () => getActivityHeatmap,
-  exportData: () => exportData,
-  deleteActivity: () => deleteActivity,
-  createReport: () => createReport
+  updateUserPreferences: () => updateUserPreferences,
+  listUserReports: () => listUserReports,
+  listUserLabs: () => listUserLabs,
+  listUserActivity: () => listUserActivity,
+  getUserPreferences: () => getUserPreferences,
+  getUserActivityStats: () => getUserActivityStats,
+  getUserActivityHeatmap: () => getUserActivityHeatmap,
+  exportUserData: () => exportUserData,
+  deleteUserActivity: () => deleteUserActivity,
+  createUserReport: () => createUserReport
 });
 // generated/dev/internal/admin.gen.ts
 var exports_admin_gen = {};
@@ -1556,5 +1574,5 @@ __export(exports_admin_gen, {
   getAdminDashboard: () => getAdminDashboard
 });
 
-//# debugId=1A71ABED851E7ACE64756E2164756E21
+//# debugId=4B0EFE7CA1477FC664756E2164756E21
 //# sourceMappingURL=index.js.map