@nodaro/sdk 2.53.1 → 2.54.0

package/dist/entries/client.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
-var chunkGAD3QCMM_cjs = require('../chunk-GAD3QCMM.cjs');
+var chunkXZRBRXGJ_cjs = require('../chunk-XZRBRXGJ.cjs');
+require('../chunk-KMNSPC72.cjs');
 require('../chunk-JTOEHQQJ.cjs');
 require('../chunk-UIDVH3GP.cjs');
 require('../chunk-W5VHATSR.cjs');
@@ -8,14 +9,15 @@ require('../chunk-R63TTR35.cjs');
 require('../chunk-3B47IHB3.cjs');
 require('../chunk-WUM6CWTE.cjs');
 require('../chunk-LKH5M44B.cjs');
+require('../chunk-SYVNY3AH.cjs');
 require('../chunk-YDRXBRW2.cjs');
 require('../chunk-WMT7HEBZ.cjs');
 require('../chunk-MBFUMWI5.cjs');
 require('../chunk-NKH2UFSD.cjs');
 require('../chunk-UIBYZNDR.cjs');
 require('../chunk-LTZKNAXM.cjs');
-require('../chunk-NWMO4MHE.cjs');
-require('../chunk-KMNSPC72.cjs');
+require('../chunk-DAONQZPI.cjs');
+require('../chunk-J5LGGCAS.cjs');
 require('../chunk-NBVARNVA.cjs');
 require('../chunk-7YHIFCJ4.cjs');
 require('../chunk-COCKKMNP.cjs');
@@ -23,30 +25,29 @@ require('../chunk-LAWYFC4G.cjs');
 require('../chunk-TCLNSVYA.cjs');
 require('../chunk-KXEWTYS4.cjs');
 require('../chunk-GB6C5OEZ.cjs');
-require('../chunk-SYVNY3AH.cjs');
+require('../chunk-JVDUGVLX.cjs');
 require('../chunk-22P4X3N5.cjs');
 require('../chunk-7QOCWJKD.cjs');
 require('../chunk-ZCWKX4V6.cjs');
 require('../chunk-Q45PC4YD.cjs');
-require('../chunk-TK2CEVSK.cjs');
+require('../chunk-VHTDOACT.cjs');
 require('../chunk-GVIFLUYZ.cjs');
-require('../chunk-CR5E2SF3.cjs');
-require('../chunk-J5LGGCAS.cjs');
+require('../chunk-W5RMFTPA.cjs');
 require('../chunk-SF2CMKWA.cjs');
 require('../chunk-SBV5MWEL.cjs');
 require('../chunk-WUKIJJG2.cjs');
 require('../chunk-P6AM42UB.cjs');
+require('../chunk-RR45WBME.cjs');
 require('../chunk-2DZWWIJ4.cjs');
 require('../chunk-SS3B6PHT.cjs');
-require('../chunk-MQ74AKA2.cjs');
 require('../chunk-WK4VXPPZ.cjs');
 require('../chunk-43FVH6LJ.cjs');
 require('../chunk-YFS2LMG4.cjs');
 require('../chunk-OSMKIRKI.cjs');
 require('../chunk-FRQJNGJS.cjs');
-var chunk76V6IQZ5_cjs = require('../chunk-76V6IQZ5.cjs');
+var chunkJOVJAKBT_cjs = require('../chunk-JOVJAKBT.cjs');
 require('../chunk-FM2KM5TY.cjs');
-require('../chunk-HGCVWOGK.cjs');
+require('../chunk-HK5FSTKG.cjs');
 require('../chunk-4BAHF762.cjs');
 require('../chunk-A3S55XGF.cjs');
 require('../chunk-JOXZ4ZIF.cjs');
@@ -54,29 +55,29 @@ require('../chunk-GA4LZZKQ.cjs');
 require('../chunk-TVPYDC5T.cjs');
 require('../chunk-65VIIZEF.cjs');
 require('../chunk-BPWUWUZ3.cjs');
-require('../chunk-HAKYPZLB.cjs');
+require('../chunk-O74MSMFH.cjs');
 
 
 
 Object.defineProperty(exports, "NodaroClient", {
   enumerable: true,
-  get: function () { return chunkGAD3QCMM_cjs.NodaroClient; }
+  get: function () { return chunkXZRBRXGJ_cjs.NodaroClient; }
 });
 Object.defineProperty(exports, "createClient", {
   enumerable: true,
-  get: function () { return chunkGAD3QCMM_cjs.createClient; }
+  get: function () { return chunkXZRBRXGJ_cjs.createClient; }
 });
 Object.defineProperty(exports, "CallbackAuth", {
   enumerable: true,
-  get: function () { return chunk76V6IQZ5_cjs.CallbackAuth; }
+  get: function () { return chunkJOVJAKBT_cjs.CallbackAuth; }
 });
 Object.defineProperty(exports, "StaticTokenAuth", {
   enumerable: true,
-  get: function () { return chunk76V6IQZ5_cjs.StaticTokenAuth; }
+  get: function () { return chunkJOVJAKBT_cjs.StaticTokenAuth; }
 });
 Object.defineProperty(exports, "supabaseAuth", {
   enumerable: true,
-  get: function () { return chunk76V6IQZ5_cjs.supabaseAuth; }
+  get: function () { return chunkJOVJAKBT_cjs.supabaseAuth; }
 });
 //# sourceMappingURL=client.cjs.map
 //# sourceMappingURL=client.cjs.map

package/dist/entries/client.d.cts

@@ -5,7 +5,7 @@ import { TrashResource } from './trash.cjs';
 import { JobsResource } from './jobs.cjs';
 import { VideoProResource } from './video-pro.cjs';
 import { ExecutionsResource } from './executions.cjs';
-import { t as NodesResource } from '../nodes-DGIefTze.cjs';
+import { t as NodesResource } from '../nodes-bY51Z1Os.cjs';
 import { Scene3DResource } from './scene3d.cjs';
 import { N as NodaroClientCore, h as DeveloperAppsResource, a as ClientOptions } from '../developer-apps-zSQXWmEG.cjs';
 export { A as Auth, C as CallbackAuth, b as ConnectedApp, S as StaticTokenAuth, i as UserIdentity, s as supabaseAuth } from '../developer-apps-zSQXWmEG.cjs';
@@ -16,6 +16,7 @@ import { CharactersResource } from './characters.cjs';
 import { LocationsResource } from './locations.cjs';
 import { ObjectsResource } from './objects.cjs';
 import { CreaturesResource } from './creatures.cjs';
+import { KeepersResource } from './keepers.cjs';
 import { PipelinesResource } from './pipelines.cjs';
 import { ReduceResource } from './reduce.cjs';
 import { PromptHelperResource } from './prompt-helper.cjs';
@@ -98,6 +99,8 @@ declare class NodaroClient extends NodaroClientCore {
     readonly locations: LocationsResource;
     readonly objects: ObjectsResource;
     readonly creatures: CreaturesResource;
+    /** The shared Nodaro Keepers catalog of characters, creatures, locations and objects. */
+    readonly keepers: KeepersResource;
     readonly pipelines: PipelinesResource;
     readonly reduce: ReduceResource;
     readonly promptHelper: PromptHelperResource;

package/dist/entries/client.d.ts

@@ -5,7 +5,7 @@ import { TrashResource } from './trash.js';
 import { JobsResource } from './jobs.js';
 import { VideoProResource } from './video-pro.js';
 import { ExecutionsResource } from './executions.js';
-import { t as NodesResource } from '../nodes-C9j0PFto.js';
+import { t as NodesResource } from '../nodes-DuXF6XVv.js';
 import { Scene3DResource } from './scene3d.js';
 import { N as NodaroClientCore, h as DeveloperAppsResource, a as ClientOptions } from '../developer-apps-zSQXWmEG.js';
 export { A as Auth, C as CallbackAuth, b as ConnectedApp, S as StaticTokenAuth, i as UserIdentity, s as supabaseAuth } from '../developer-apps-zSQXWmEG.js';
@@ -16,6 +16,7 @@ import { CharactersResource } from './characters.js';
 import { LocationsResource } from './locations.js';
 import { ObjectsResource } from './objects.js';
 import { CreaturesResource } from './creatures.js';
+import { KeepersResource } from './keepers.js';
 import { PipelinesResource } from './pipelines.js';
 import { ReduceResource } from './reduce.js';
 import { PromptHelperResource } from './prompt-helper.js';
@@ -98,6 +99,8 @@ declare class NodaroClient extends NodaroClientCore {
     readonly locations: LocationsResource;
     readonly objects: ObjectsResource;
     readonly creatures: CreaturesResource;
+    /** The shared Nodaro Keepers catalog of characters, creatures, locations and objects. */
+    readonly keepers: KeepersResource;
     readonly pipelines: PipelinesResource;
     readonly reduce: ReduceResource;
     readonly promptHelper: PromptHelperResource;

package/dist/entries/client.js

@@ -1,4 +1,5 @@
-export { NodaroClient, createClient } from '../chunk-HLYRNWHW.js';
+export { NodaroClient, createClient } from '../chunk-EZXFDCII.js';
+import '../chunk-HPXE3NZW.js';
 import '../chunk-WY4QRJZW.js';
 import '../chunk-LR5TGCJP.js';
 import '../chunk-ERLXU47J.js';
@@ -6,14 +7,15 @@ import '../chunk-T7N7DFQJ.js';
 import '../chunk-YN6CBIIB.js';
 import '../chunk-33HT46A3.js';
 import '../chunk-Z5GLY4R3.js';
+import '../chunk-NCCBS6GU.js';
 import '../chunk-NNHWH7ER.js';
 import '../chunk-WS4ZQ4AA.js';
 import '../chunk-WVFAQBS7.js';
 import '../chunk-AUKHMT53.js';
 import '../chunk-M7VSFZMV.js';
 import '../chunk-2SQ7V6EX.js';
-import '../chunk-35CNQ3WW.js';
-import '../chunk-HPXE3NZW.js';
+import '../chunk-HAVIVOLO.js';
+import '../chunk-ALSLZG3U.js';
 import '../chunk-WEQWU2IC.js';
 import '../chunk-KFZOJBI5.js';
 import '../chunk-K4RQOSJH.js';
@@ -21,30 +23,29 @@ import '../chunk-H7VQTG4M.js';
 import '../chunk-OIPPTBW4.js';
 import '../chunk-AJVSMNPZ.js';
 import '../chunk-IHKIYVZQ.js';
-import '../chunk-NCCBS6GU.js';
+import '../chunk-I3MEBVLP.js';
 import '../chunk-BQAW4RX2.js';
 import '../chunk-Y6V6CBY5.js';
 import '../chunk-YVU2M7MI.js';
 import '../chunk-AEUPH7EE.js';
-import '../chunk-GW76IRQD.js';
+import '../chunk-47ULSVO2.js';
 import '../chunk-Z7LGWNI7.js';
-import '../chunk-7LSFG2AF.js';
-import '../chunk-ALSLZG3U.js';
+import '../chunk-QGVOAPUI.js';
 import '../chunk-RBX3QTKB.js';
 import '../chunk-Z3ZKFI2M.js';
 import '../chunk-JDEZHITT.js';
 import '../chunk-THLTFB6I.js';
+import '../chunk-MQWZFWHE.js';
 import '../chunk-P6E4QDJN.js';
 import '../chunk-E37CVHWW.js';
-import '../chunk-TVENC6PH.js';
 import '../chunk-4WRDR4GN.js';
 import '../chunk-SFB4YLCS.js';
 import '../chunk-BU5A6K4C.js';
 import '../chunk-D2ILCSOQ.js';
 import '../chunk-7CUWAVWB.js';
-export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-V5MY46JA.js';
+export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-AN36M6HO.js';
 import '../chunk-L6T44A3G.js';
-import '../chunk-CK3AMMSC.js';
+import '../chunk-HWSYNUSC.js';
 import '../chunk-7QK2NXJA.js';
 import '../chunk-65E3JBFZ.js';
 import '../chunk-7LODCIQK.js';
@@ -52,6 +53,6 @@ import '../chunk-3QFTP5P5.js';
 import '../chunk-ZVKEPVDQ.js';
 import '../chunk-DV6GTEX5.js';
 import '../chunk-KG4R454Z.js';
-import '../chunk-EJSGJDZY.js';
+import '../chunk-PBFODIFT.js';
 //# sourceMappingURL=client.js.map
 //# sourceMappingURL=client.js.map

package/dist/entries/core.cjs

@@ -1,26 +1,26 @@
 'use strict';
 
 require('../chunk-X7XP5WBP.cjs');
-var chunk76V6IQZ5_cjs = require('../chunk-76V6IQZ5.cjs');
+var chunkJOVJAKBT_cjs = require('../chunk-JOVJAKBT.cjs');
 require('../chunk-FM2KM5TY.cjs');
 
 
 
 Object.defineProperty(exports, "CallbackAuth", {
   enumerable: true,
-  get: function () { return chunk76V6IQZ5_cjs.CallbackAuth; }
+  get: function () { return chunkJOVJAKBT_cjs.CallbackAuth; }
 });
 Object.defineProperty(exports, "NodaroClientCore", {
   enumerable: true,
-  get: function () { return chunk76V6IQZ5_cjs.NodaroClientCore; }
+  get: function () { return chunkJOVJAKBT_cjs.NodaroClientCore; }
 });
 Object.defineProperty(exports, "StaticTokenAuth", {
   enumerable: true,
-  get: function () { return chunk76V6IQZ5_cjs.StaticTokenAuth; }
+  get: function () { return chunkJOVJAKBT_cjs.StaticTokenAuth; }
 });
 Object.defineProperty(exports, "supabaseAuth", {
   enumerable: true,
-  get: function () { return chunk76V6IQZ5_cjs.supabaseAuth; }
+  get: function () { return chunkJOVJAKBT_cjs.supabaseAuth; }
 });
 //# sourceMappingURL=core.cjs.map
 //# sourceMappingURL=core.cjs.map

package/dist/entries/core.js

@@ -1,5 +1,5 @@
 import '../chunk-AUDHV3OE.js';
-export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-V5MY46JA.js';
+export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-AN36M6HO.js';
 import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=core.js.map
 //# sourceMappingURL=core.js.map

package/dist/entries/creatures.cjs

@@ -1,29 +1,29 @@
 'use strict';
 
 require('../chunk-4WWSHV5G.cjs');
-var chunkHGCVWOGK_cjs = require('../chunk-HGCVWOGK.cjs');
+var chunkHK5FSTKG_cjs = require('../chunk-HK5FSTKG.cjs');
 
 
 
 Object.defineProperty(exports, "CREATURE_ASPECT_DEFAULTS", {
   enumerable: true,
-  get: function () { return chunkHGCVWOGK_cjs.OBJECT_ASPECT_DEFAULTS; }
+  get: function () { return chunkHK5FSTKG_cjs.OBJECT_ASPECT_DEFAULTS; }
 });
 Object.defineProperty(exports, "CREATURE_ASPECT_OPTIONS", {
   enumerable: true,
-  get: function () { return chunkHGCVWOGK_cjs.OBJECT_ASPECT_OPTIONS; }
+  get: function () { return chunkHK5FSTKG_cjs.OBJECT_ASPECT_OPTIONS; }
 });
 Object.defineProperty(exports, "CREATURE_ASSET_TYPES", {
   enumerable: true,
-  get: function () { return chunkHGCVWOGK_cjs.CREATURE_ASSET_TYPES; }
+  get: function () { return chunkHK5FSTKG_cjs.CREATURE_ASSET_TYPES; }
 });
 Object.defineProperty(exports, "CREATURE_ATTACH_COLUMNS", {
   enumerable: true,
-  get: function () { return chunkHGCVWOGK_cjs.CREATURE_ATTACH_COLUMNS; }
+  get: function () { return chunkHK5FSTKG_cjs.CREATURE_ATTACH_COLUMNS; }
 });
 Object.defineProperty(exports, "CreaturesResource", {
   enumerable: true,
-  get: function () { return chunkHGCVWOGK_cjs.CreaturesResource; }
+  get: function () { return chunkHK5FSTKG_cjs.CreaturesResource; }
 });
 //# sourceMappingURL=creatures.cjs.map
 //# sourceMappingURL=creatures.cjs.map

package/dist/entries/creatures.d.cts

@@ -2,7 +2,8 @@ import { CreatureAttachColumn, ObjectAspectRatio } from '@nodaro/shared/entities
 export { OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn } from '@nodaro/shared/entities';
 import { TtsProvider } from '@nodaro/shared/models';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
-import { l as GenerationSessionParams } from '../nodes-DGIefTze.cjs';
+import { l as GenerationSessionParams, a3 as Subject } from '../nodes-bY51Z1Os.cjs';
+import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';
@@ -329,6 +330,13 @@ interface GenerateCreatureInput extends GenerationSessionParams {
     attachToCreatureId?: string;
     /** Parameter-picker prompt-fragment pass-through. */
     seedPromptHint?: string;
+    /**
+     * What the creature is, as picker-catalog ids ({@link Subject} — `animal`
+     * above all; the same type and bounds as `generateImage`'s). The platform
+     * writes the wording and folds it into the prompt after `description`, so
+     * send ids rather than phrasing a pick yourself.
+     */
+    subject?: Subject;
     /** Optional name to set on the attached row alongside the main image. */
     attachName?: string;
     /** Optimistic-concurrency token for the single-candidate auto-attach path. */
@@ -528,6 +536,13 @@ declare class CreaturesResource {
         id: string;
         name: string;
     }>;
+    /**
+     * Admin only: put one of your own creatures on the shared Nodaro Keepers
+     * shelf (`client.keepers.catalog()`), or take it off. A first-party session
+     * or your personal token; `forbidden` for anyone who is not a platform
+     * admin, `not_found` for a row that is not yours.
+     */
+    setCatalog(id: string, input: SetKeeperCatalogInput): Promise<SetKeeperCatalogResult>;
     /**
      * Fire `POST /v1/generate-creature` to produce one or more candidate main
      * images. With `count > 1`, all jobs are reserved up-front before any

package/dist/entries/creatures.d.ts

@@ -2,7 +2,8 @@ import { CreatureAttachColumn, ObjectAspectRatio } from '@nodaro/shared/entities
 export { OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn } from '@nodaro/shared/entities';
 import { TtsProvider } from '@nodaro/shared/models';
 import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
-import { l as GenerationSessionParams } from '../nodes-C9j0PFto.js';
+import { l as GenerationSessionParams, a3 as Subject } from '../nodes-DuXF6XVv.js';
+import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 import '@nodaro/shared/types';
@@ -329,6 +330,13 @@ interface GenerateCreatureInput extends GenerationSessionParams {
     attachToCreatureId?: string;
     /** Parameter-picker prompt-fragment pass-through. */
     seedPromptHint?: string;
+    /**
+     * What the creature is, as picker-catalog ids ({@link Subject} — `animal`
+     * above all; the same type and bounds as `generateImage`'s). The platform
+     * writes the wording and folds it into the prompt after `description`, so
+     * send ids rather than phrasing a pick yourself.
+     */
+    subject?: Subject;
     /** Optional name to set on the attached row alongside the main image. */
     attachName?: string;
     /** Optimistic-concurrency token for the single-candidate auto-attach path. */
@@ -528,6 +536,13 @@ declare class CreaturesResource {
         id: string;
         name: string;
     }>;
+    /**
+     * Admin only: put one of your own creatures on the shared Nodaro Keepers
+     * shelf (`client.keepers.catalog()`), or take it off. A first-party session
+     * or your personal token; `forbidden` for anyone who is not a platform
+     * admin, `not_found` for a row that is not yours.
+     */
+    setCatalog(id: string, input: SetKeeperCatalogInput): Promise<SetKeeperCatalogResult>;
     /**
      * Fire `POST /v1/generate-creature` to produce one or more candidate main
      * images. With `count > 1`, all jobs are reserved up-front before any

package/dist/entries/creatures.js

@@ -1,4 +1,4 @@
 import '../chunk-EXLAHZKF.js';
-export { OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ASSET_TYPES, CREATURE_ATTACH_COLUMNS, CreaturesResource } from '../chunk-CK3AMMSC.js';
+export { OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ASSET_TYPES, CREATURE_ATTACH_COLUMNS, CreaturesResource } from '../chunk-HWSYNUSC.js';
 //# sourceMappingURL=creatures.js.map
 //# sourceMappingURL=creatures.js.map

package/dist/entries/keepers.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+require('../chunk-NQF6UKND.cjs');
+var chunkRR45WBME_cjs = require('../chunk-RR45WBME.cjs');
+
+
+
+Object.defineProperty(exports, "KEEPER_KINDS", {
+  enumerable: true,
+  get: function () { return chunkRR45WBME_cjs.KEEPER_KINDS; }
+});
+Object.defineProperty(exports, "KeepersResource", {
+  enumerable: true,
+  get: function () { return chunkRR45WBME_cjs.KeepersResource; }
+});
+//# sourceMappingURL=keepers.cjs.map
+//# sourceMappingURL=keepers.cjs.map

package/dist/entries/keepers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"keepers.cjs"}

package/dist/entries/keepers.d.cts

@@ -0,0 +1,100 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Nodaro Keepers — the shared catalog of characters, creatures, locations and
+ * objects (`/v1/keepers/catalog`). An admin puts some of their own items on
+ * the shelf; everyone browses it (the read takes no credential — a guest
+ * sees it too); using one copies it into the caller's own account as a row
+ * of their own, editable in Studio. The original is never changed, a later
+ * change to it does not reach the copies, and taking it off the shelf
+ * removes no copy. No credits for reading or copying.
+ */
+declare const KEEPER_KINDS: readonly ["character", "creature", "location", "object"];
+type KeeperKind = (typeof KEEPER_KINDS)[number];
+/** One item on the shelf — display fields only. */
+interface KeeperCatalogItem {
+    id: string;
+    kind: KeeperKind;
+    name: string;
+    description: string | null;
+    /** The main image, as stored. */
+    imageUrl: string;
+    /** A 480px-wide copy of it for a tile (the image itself where the CDN does not resize). */
+    previewUrl: string;
+    /** The shelf heading the admin filed it under, if any. */
+    category: string | null;
+    /** The shelf order, lowest first. */
+    sort: number;
+    createdAt: string;
+}
+interface KeeperCatalogParams {
+    /** One kind only; omitted, the page runs through the kinds in `KEEPER_KINDS` order. */
+    kind?: KeeperKind;
+    /** A previous page's `next`. */
+    cursor?: string;
+    /** 1–200, default 50. */
+    limit?: number;
+}
+interface KeeperCatalogPage {
+    data: KeeperCatalogItem[];
+    /** The next page's cursor, or null on the last page. */
+    next: string | null;
+}
+/** The caller's own copy of a shelf item. */
+interface CopyKeeperResult {
+    /** The id of the caller's row — `client.characters.get(id)` and the others read it. */
+    id: string;
+    name: string;
+    kind: KeeperKind;
+    /** `false` when the caller already had a copy of this item: that copy is returned, no second one is made. */
+    created: boolean;
+}
+/** `client.<kind>.setCatalog(id, input)` — admin only, on the admin's own rows. */
+interface SetKeeperCatalogInput {
+    /** On the shelf, or not. */
+    catalog: boolean;
+    /** The shelf order, lowest first (default 0). */
+    sort?: number;
+    /** A shelf heading; `null` clears it. */
+    category?: string | null;
+}
+interface SetKeeperCatalogResult {
+    id: string;
+    kind: KeeperKind;
+    catalog: boolean;
+    sort: number;
+    category: string | null;
+}
+declare class KeepersResource {
+    private readonly client;
+    constructor(client: NodaroClientCore);
+    /**
+     * One page of the shelf. Public data: the same for every caller.
+     *
+     * ```ts
+     * const { data, next } = await client.keepers.catalog({ kind: "character" })
+     * ```
+     */
+    catalog(params?: KeeperCatalogParams): Promise<KeeperCatalogPage>;
+    /**
+     * Use a shelf item: a copy of it in the caller's account — their own row,
+     * made like a community clone: the public text, the main image and the
+     * variant assets (every file copied into the caller's own storage and
+     * counted against it), a custom voice reduced to its name and sample,
+     * editable in Studio. Calling again returns the same copy
+     * (`created: false`). No credits. A 413 `storage_limit_exceeded` when the
+     * files do not fit the caller's storage; `ForbiddenError`
+     * `personal_space_disabled` when their organization closed the personal
+     * space.
+     *
+     * ```ts
+     * const { id } = await client.keepers.copy("character", item.id)
+     * const mine = await client.characters.get(id)
+     * ```
+     */
+    copy(kind: KeeperKind, id: string): Promise<CopyKeeperResult>;
+}
+
+export { type CopyKeeperResult, KEEPER_KINDS, type KeeperCatalogItem, type KeeperCatalogPage, type KeeperCatalogParams, type KeeperKind, KeepersResource, type SetKeeperCatalogInput, type SetKeeperCatalogResult };

package/dist/entries/keepers.d.ts

@@ -0,0 +1,100 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Nodaro Keepers — the shared catalog of characters, creatures, locations and
+ * objects (`/v1/keepers/catalog`). An admin puts some of their own items on
+ * the shelf; everyone browses it (the read takes no credential — a guest
+ * sees it too); using one copies it into the caller's own account as a row
+ * of their own, editable in Studio. The original is never changed, a later
+ * change to it does not reach the copies, and taking it off the shelf
+ * removes no copy. No credits for reading or copying.
+ */
+declare const KEEPER_KINDS: readonly ["character", "creature", "location", "object"];
+type KeeperKind = (typeof KEEPER_KINDS)[number];
+/** One item on the shelf — display fields only. */
+interface KeeperCatalogItem {
+    id: string;
+    kind: KeeperKind;
+    name: string;
+    description: string | null;
+    /** The main image, as stored. */
+    imageUrl: string;
+    /** A 480px-wide copy of it for a tile (the image itself where the CDN does not resize). */
+    previewUrl: string;
+    /** The shelf heading the admin filed it under, if any. */
+    category: string | null;
+    /** The shelf order, lowest first. */
+    sort: number;
+    createdAt: string;
+}
+interface KeeperCatalogParams {
+    /** One kind only; omitted, the page runs through the kinds in `KEEPER_KINDS` order. */
+    kind?: KeeperKind;
+    /** A previous page's `next`. */
+    cursor?: string;
+    /** 1–200, default 50. */
+    limit?: number;
+}
+interface KeeperCatalogPage {
+    data: KeeperCatalogItem[];
+    /** The next page's cursor, or null on the last page. */
+    next: string | null;
+}
+/** The caller's own copy of a shelf item. */
+interface CopyKeeperResult {
+    /** The id of the caller's row — `client.characters.get(id)` and the others read it. */
+    id: string;
+    name: string;
+    kind: KeeperKind;
+    /** `false` when the caller already had a copy of this item: that copy is returned, no second one is made. */
+    created: boolean;
+}
+/** `client.<kind>.setCatalog(id, input)` — admin only, on the admin's own rows. */
+interface SetKeeperCatalogInput {
+    /** On the shelf, or not. */
+    catalog: boolean;
+    /** The shelf order, lowest first (default 0). */
+    sort?: number;
+    /** A shelf heading; `null` clears it. */
+    category?: string | null;
+}
+interface SetKeeperCatalogResult {
+    id: string;
+    kind: KeeperKind;
+    catalog: boolean;
+    sort: number;
+    category: string | null;
+}
+declare class KeepersResource {
+    private readonly client;
+    constructor(client: NodaroClientCore);
+    /**
+     * One page of the shelf. Public data: the same for every caller.
+     *
+     * ```ts
+     * const { data, next } = await client.keepers.catalog({ kind: "character" })
+     * ```
+     */
+    catalog(params?: KeeperCatalogParams): Promise<KeeperCatalogPage>;
+    /**
+     * Use a shelf item: a copy of it in the caller's account — their own row,
+     * made like a community clone: the public text, the main image and the
+     * variant assets (every file copied into the caller's own storage and
+     * counted against it), a custom voice reduced to its name and sample,
+     * editable in Studio. Calling again returns the same copy
+     * (`created: false`). No credits. A 413 `storage_limit_exceeded` when the
+     * files do not fit the caller's storage; `ForbiddenError`
+     * `personal_space_disabled` when their organization closed the personal
+     * space.
+     *
+     * ```ts
+     * const { id } = await client.keepers.copy("character", item.id)
+     * const mine = await client.characters.get(id)
+     * ```
+     */
+    copy(kind: KeeperKind, id: string): Promise<CopyKeeperResult>;
+}
+
+export { type CopyKeeperResult, KEEPER_KINDS, type KeeperCatalogItem, type KeeperCatalogPage, type KeeperCatalogParams, type KeeperKind, KeepersResource, type SetKeeperCatalogInput, type SetKeeperCatalogResult };

package/dist/entries/keepers.js

@@ -0,0 +1,4 @@
+import '../chunk-BEQCU7YJ.js';
+export { KEEPER_KINDS, KeepersResource } from '../chunk-MQWZFWHE.js';
+//# sourceMappingURL=keepers.js.map
+//# sourceMappingURL=keepers.js.map

package/dist/entries/keepers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"keepers.js"}

package/dist/entries/locations.cjs

@@ -1,25 +1,25 @@
 'use strict';
 
 require('../chunk-YXBZRB5H.cjs');
-var chunkMQ74AKA2_cjs = require('../chunk-MQ74AKA2.cjs');
+var chunkJVDUGVLX_cjs = require('../chunk-JVDUGVLX.cjs');
 
 
 
 Object.defineProperty(exports, "LOCATION_ASSET_TYPES", {
   enumerable: true,
-  get: function () { return chunkMQ74AKA2_cjs.LOCATION_ASSET_TYPES; }
+  get: function () { return chunkJVDUGVLX_cjs.LOCATION_ASSET_TYPES; }
 });
 Object.defineProperty(exports, "LOCATION_ATTACH_COLUMNS", {
   enumerable: true,
-  get: function () { return chunkMQ74AKA2_cjs.LOCATION_ATTACH_COLUMNS; }
+  get: function () { return chunkJVDUGVLX_cjs.LOCATION_ATTACH_COLUMNS; }
 });
 Object.defineProperty(exports, "LocationsResource", {
   enumerable: true,
-  get: function () { return chunkMQ74AKA2_cjs.LocationsResource; }
+  get: function () { return chunkJVDUGVLX_cjs.LocationsResource; }
 });
 Object.defineProperty(exports, "SURROUND_DIRECTIONS", {
   enumerable: true,
-  get: function () { return chunkMQ74AKA2_cjs.SURROUND_DIRECTIONS; }
+  get: function () { return chunkJVDUGVLX_cjs.SURROUND_DIRECTIONS; }
 });
 //# sourceMappingURL=locations.cjs.map
 //# sourceMappingURL=locations.cjs.map