@brigadasos/nadeshiko-sdk 1.5.0-dev.9402be1 → 1.5.0-dev.c2b9767

package/README.md

@@ -8,7 +8,7 @@ TypeScript SDK for the [Nadeshiko API](https://nadeshiko.co).
 bun add @brigadasos/nadeshiko-sdk
 ```
 
-Install the internal build (includes internal endpoints) via the `internal` dist-tag:
+Install the internal build (includes internal + session-authenticated endpoints) via the `internal` dist-tag:
 
 ```bash
 bun add @brigadasos/nadeshiko-sdk@internal
@@ -21,20 +21,23 @@ bun add @brigadasos/nadeshiko-sdk@internal
 Use an API key for endpoints that don't require a user session. The key is sent as `Authorization: Bearer <apiKey>`.
 
 ```typescript
-import { createNadeshikoClient, searchSegments } from '@brigadasos/nadeshiko-sdk';
+import { createNadeshikoClient, search } from '@brigadasos/nadeshiko-sdk';
 
 const client = createNadeshikoClient({
   apiKey: process.env.NADESHIKO_API_KEY!,
   baseUrl: 'PRODUCTION',
 });
 
-const result = await searchSegments({
+const result = await search({
   client,
-  body: { query: '彼女' },
+  body: { query: { search: '彼女' } },
 });
 ```
 
-### Session token (user-authenticated endpoints)
+### Session token (user-authenticated endpoints, internal build only)
+
+The default public package intentionally exposes API-key-capable endpoints only.
+For session-authenticated endpoints (for example `/v1/user/*` and `/v1/collections/*`), use the internal build.
 
 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.
 
@@ -60,23 +63,23 @@ export default defineEventHandler(async (event) => {
 });
 ```
 
-**Browser (no configuration needed):** the default `sessionToken` getter reads `nadeshiko.session_token` from `document.cookie` automatically.
+**Browser note:** if your session cookie is `HttpOnly`, use same-origin proxy routes and let the browser attach cookies automatically. Prefer server-side session handling for internal endpoints.
 
 ### 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 { createNadeshikoClient, searchSegments } from '@brigadasos/nadeshiko-sdk';
+import { createNadeshikoClient, search } from '@brigadasos/nadeshiko-sdk';
 
 const client = createNadeshikoClient({
   apiKey: process.env.NADESHIKO_API_KEY!,
   baseUrl: 'PRODUCTION',
 });
 
-const result = await searchSegments({
+const result = await search({
   client,
-  body: { query: '食べる' },
+  body: { query: { search: '食べる' } },
 });
 
 if (result.error) {
@@ -134,8 +137,8 @@ if (result.error) {
 }
 
 // result.data is fully typed as SearchResponse
-for (const hit of result.data.results ?? []) {
-  console.log(hit.segment.ja.content, '—', hit.media.nameEn);
+for (const segment of result.data.segments ?? []) {
+  console.log(segment.content.ja.content);
 }
 ```
 
@@ -145,13 +148,13 @@ If you prefer exceptions over checking `.error`, pass `throwOnError: true`. The
 
 ```typescript
 try {
-  const { data } = await searchSegments({
+  const { data } = await search({
     client,
     throwOnError: true,
-    body: { query: '彼女' },
+    body: { query: { search: '彼女' } },
   });
 
-  console.log(data.results);
+  console.log(data.segments);
 } catch (error) {
   console.error('Request failed:', error);
 }

package/dist/index.cjs

@@ -972,7 +972,11 @@ var autocompleteMedia = (options) => (options.client ?? client).get({
   ...options
 });
 var getSegmentByUuid = (options) => (options.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{ scheme: "bearer", type: "http" }, {
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/media/segments/{uuid}",
   ...options
 });
@@ -990,7 +994,11 @@ var updateSegmentByUuid = (options) => (options.client ?? client).patch({
   }
 });
 var getSegmentContext = (options) => (options.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{ scheme: "bearer", type: "http" }, {
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/media/segments/{uuid}/context",
   ...options
 });
@@ -1399,17 +1407,29 @@ var getCollectionStats = (options) => (options.client ?? client).get({
   ...options
 });
 var getAdminDashboard = (options) => (options?.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/dashboard",
   ...options
 });
 var getAdminHealth = (options) => (options?.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/health",
   ...options
 });
 var triggerReindex = (options) => (options?.client ?? client).post({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/reindex",
   ...options,
   headers: {
@@ -1418,45 +1438,52 @@ var triggerReindex = (options) => (options?.client ?? client).post({
   }
 });
 var listAdminQueueStats = (options) => (options?.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/queues/stats",
   ...options
 });
 var getAdminQueue = (options) => (options.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/queues/{queueName}",
   ...options
 });
 var listAdminQueueFailed = (options) => (options.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/queues/{queueName}/failed",
   ...options
 });
 var retryAdminQueueFailed = (options) => (options.client ?? client).post({
-  security: [{ scheme: "bearer", type: "http" }],
-  url: "/v1/admin/queues/{queueName}/retry",
-  ...options
-});
-var purgeAdminQueueFailed = (options) => (options.client ?? client).delete({
-  security: [{ scheme: "bearer", type: "http" }],
-  url: "/v1/admin/queues/{queueName}/purge",
-  ...options
-});
-var clearAdminImpersonation = (options) => (options?.client ?? client).delete({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
     type: "apiKey"
   }],
-  url: "/v1/admin/impersonation",
+  url: "/v1/admin/queues/{queueName}/retry",
   ...options
 });
-var impersonateAdminUser = (options) => (options.client ?? client).post({
+var purgeAdminQueueFailed = (options) => (options.client ?? client).delete({
   security: [{
     in: "cookie",
     name: "nadeshiko.session_token",
     type: "apiKey"
   }],
+  url: "/v1/admin/queues/{queueName}/purge",
+  ...options
+});
+var clearAdminImpersonation = (options) => (options?.client ?? client).delete({ url: "/v1/admin/impersonation", ...options });
+var impersonateAdminUser = (options) => (options.client ?? client).post({
   url: "/v1/admin/impersonation",
   ...options,
   headers: {
@@ -1465,12 +1492,20 @@ var impersonateAdminUser = (options) => (options.client ?? client).post({
   }
 });
 var listAdminReports = (options) => (options?.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/reports",
   ...options
 });
 var updateAdminReport = (options) => (options.client ?? client).patch({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/reports/{id}",
   ...options,
   headers: {
@@ -1479,12 +1514,20 @@ var updateAdminReport = (options) => (options.client ?? client).patch({
   }
 });
 var listAdminMediaAudits = (options) => (options?.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/media/audits",
   ...options
 });
 var updateAdminMediaAudit = (options) => (options.client ?? client).patch({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/media/audits/{name}",
   ...options,
   headers: {
@@ -1493,17 +1536,29 @@ var updateAdminMediaAudit = (options) => (options.client ?? client).patch({
   }
 });
 var runAdminMediaAudit = (options) => (options.client ?? client).post({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/media/audits/{name}/run",
   ...options
 });
 var listAdminMediaAuditRuns = (options) => (options?.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/media/audits/runs",
   ...options
 });
 var getAdminMediaAuditRun = (options) => (options.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
+  security: [{
+    in: "cookie",
+    name: "nadeshiko.session_token",
+    type: "apiKey"
+  }],
   url: "/v1/admin/media/audits/runs/{id}",
   ...options
 });
@@ -1520,7 +1575,13 @@ var defaultSessionTokenGetter = () => {
   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 baseUrl = config.baseUrl === undefined ? environments.PRODUCTION : (config.baseUrl in environments) ? environments[config.baseUrl] : config.baseUrl;
+  const getApiKey = async () => {
+    if (typeof config.apiKey === "function") {
+      return await config.apiKey();
+    }
+    return config.apiKey;
+  };
   const getSessionToken = config.sessionToken ?? defaultSessionTokenGetter;
   const clientInstance = createClient(createConfig({
     baseUrl,
@@ -1528,7 +1589,7 @@ function createNadeshikoClient(config) {
       if (auth.in === "cookie") {
         return getSessionToken();
       }
-      return config.apiKey;
+      return getApiKey();
     }
   }));
   return {
@@ -1686,5 +1747,5 @@ __export(exports_admin_gen, {
   clearAdminImpersonation: () => clearAdminImpersonation
 });
 
-//# debugId=E295580D1109844C64756E2164756E21
+//# debugId=C46407DD30C813FE64756E2164756E21
 //# sourceMappingURL=index.js.map