@game-infra/story-schemas 0.2.0

package/dist/designContent.d.ts

@@ -0,0 +1,236 @@
+import { type InferOutput } from "valibot";
+/**
+ * The transport for everything an author writes: worlds, the content written
+ * against them (locations, characters, skill definitions, lore entries), the
+ * story arcs chosen for a world, and the beats those arcs are told in.
+ *
+ * All of it is one shape — a keyed JSON payload, scoped to a parent, tagged
+ * with a type — so it is one resource rather than a family of near-identical
+ * ones. The service stores and indexes `data`; it never parses it. That is the
+ * same rule `GameEntitySaveRequestSchema` follows in `@game-infra/api-schemas-core`,
+ * and it is what lets a game's design vocabulary move without a contract bump.
+ *
+ * The shapes that go *inside* `data` are typed too — see `storyPayloads.ts` —
+ * but as schemas a client parses with, not as part of any endpoint.
+ */
+/**
+ * The scope of a row that has no parent. A world is scoped to nothing, but the
+ * key `(contentType, scopeId, contentId)` still needs three parts and a URL
+ * cannot carry an empty path segment, so unparented rows spell their scope `-`.
+ *
+ * @example
+ * ```ts
+ * import { ROOT_SCOPE, designContentLoadContract } from '@game-infra/story-schemas'
+ *
+ * designContentLoadContract.pathResolver({
+ *   gameId: 'g1', contentType: 'world', scopeId: ROOT_SCOPE, contentId: 'the-ash-reckoning',
+ * }) // '/games/g1/design-content/world/-/the-ash-reckoning'
+ * ```
+ */
+export declare const ROOT_SCOPE = "-";
+/**
+ * The vocabulary this contract was written against, and how each type is scoped:
+ *
+ * | Type                                                          | Scoped to    |
+ * | ------------------------------------------------------------- | ------------ |
+ * | `world`                                                       | {@link ROOT_SCOPE} |
+ * | `locations`, `characters`, `events`, `stats`, `skills`, `perks`, `resources`, `lore` | a world id |
+ * | `story-arc`                                                   | a world id   |
+ * | `story-node`                                                  | a story id   |
+ *
+ * `contentType` is a plain `string()` in every schema below — a game re-tightens
+ * it in its own validation layer — so treat this as the suggested set, not a
+ * closed one. The plural spellings match the collections of a design document;
+ * the singular ones name things there is one of.
+ *
+ * @example
+ * ```ts
+ * import { DESIGN_CONTENT_TYPES } from '@game-infra/story-schemas'
+ *
+ * DESIGN_CONTENT_TYPES.includes('story-node') // true
+ * ```
+ */
+export declare const DESIGN_CONTENT_TYPES: readonly ["world", "locations", "characters", "events", "stats", "skills", "perks", "resources", "lore", "story-arc", "story-node"];
+/** One of {@link DESIGN_CONTENT_TYPES}, widened to `string` at the wire boundary. */
+export type DesignContentType = (typeof DESIGN_CONTENT_TYPES)[number];
+/**
+ * One row.
+ *
+ * `data` is present only when the request asked for it — a listing returns
+ * metadata by default, because a world picker needs names and counts, not
+ * every character's biography.
+ *
+ * @example
+ * ```ts
+ * import type { DesignContentRecord } from '@game-infra/story-schemas'
+ *
+ * const row: DesignContentRecord = {
+ *   contentType: 'characters',
+ *   scopeId: 'the-ash-reckoning',
+ *   contentId: 'tallow',
+ *   name: 'Tallow',
+ *   data: JSON.stringify({ id: 'tallow', name: 'Tallow', role: 'Drift-runner' }),
+ *   createdAt: '2026-08-29T09:00:00.000Z',
+ *   updatedAt: '2026-08-29T09:30:00.000Z',
+ * }
+ * ```
+ */
+export declare const DesignContentRecordSchema: import("valibot").ObjectSchema<{
+    readonly contentType: import("valibot").StringSchema<undefined>;
+    readonly scopeId: import("valibot").StringSchema<undefined>;
+    readonly contentId: import("valibot").StringSchema<undefined>;
+    /** For display in a picker, so a list need not carry payloads to be readable. */
+    readonly name: import("valibot").StringSchema<undefined>;
+    readonly data: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+    readonly createdAt: import("valibot").StringSchema<undefined>;
+    readonly updatedAt: import("valibot").StringSchema<undefined>;
+}, undefined>;
+export type DesignContentRecord = InferOutput<typeof DesignContentRecordSchema>;
+/**
+ * Create or replace one row. Re-saving the same key keeps its `createdAt`.
+ *
+ * @example
+ * ```ts
+ * import type { DesignContentSaveRequest } from '@game-infra/story-schemas'
+ *
+ * const request: DesignContentSaveRequest = {
+ *   contentType: 'story-node',
+ *   scopeId: 'the-quiet-forge-answers',
+ *   contentId: 'root.take-the-tunnel',
+ *   name: 'take-the-tunnel',
+ *   data: JSON.stringify({ narration: 'The tunnel breathes out ash…', choices: [] }),
+ * }
+ * ```
+ */
+export declare const DesignContentSaveRequestSchema: import("valibot").ObjectSchema<{
+    readonly contentType: import("valibot").StringSchema<undefined>;
+    readonly scopeId: import("valibot").StringSchema<undefined>;
+    readonly contentId: import("valibot").StringSchema<undefined>;
+    readonly name: import("valibot").StringSchema<undefined>;
+    readonly data: import("valibot").StringSchema<undefined>;
+}, undefined>;
+export type DesignContentSaveRequest = InferOutput<typeof DesignContentSaveRequestSchema>;
+/**
+ * What a bulk save clears before it writes.
+ *
+ * Omitting `contentType` sweeps the whole scope. Naming one sweeps just that
+ * type within it, which is the usual case: "these are all the locations for
+ * this world" has to remove the location the author deleted locally, or it
+ * would survive on the server forever.
+ */
+export declare const DesignContentReplaceScopeSchema: import("valibot").ObjectSchema<{
+    readonly scopeId: import("valibot").StringSchema<undefined>;
+    readonly contentType: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+}, undefined>;
+export type DesignContentReplaceScope = InferOutput<typeof DesignContentReplaceScopeSchema>;
+/**
+ * Write many rows at once, optionally as a snapshot rather than a merge.
+ *
+ * A whole design document — the world plus every collection — lands in one
+ * request this way.
+ *
+ * @example
+ * ```ts
+ * import type { DesignContentBulkSaveRequest } from '@game-infra/story-schemas'
+ *
+ * const request: DesignContentBulkSaveRequest = {
+ *   items: [
+ *     {
+ *       contentType: 'locations',
+ *       scopeId: 'the-ash-reckoning',
+ *       contentId: 'cinderhold',
+ *       name: 'Cinderhold',
+ *       data: '{}',
+ *     },
+ *   ],
+ *   replace: [{ scopeId: 'the-ash-reckoning', contentType: 'locations' }],
+ * }
+ * ```
+ */
+export declare const DesignContentBulkSaveRequestSchema: import("valibot").ObjectSchema<{
+    readonly items: import("valibot").ArraySchema<import("valibot").ObjectSchema<{
+        readonly contentType: import("valibot").StringSchema<undefined>;
+        readonly scopeId: import("valibot").StringSchema<undefined>;
+        readonly contentId: import("valibot").StringSchema<undefined>;
+        readonly name: import("valibot").StringSchema<undefined>;
+        readonly data: import("valibot").StringSchema<undefined>;
+    }, undefined>, undefined>;
+    readonly replace: import("valibot").OptionalSchema<import("valibot").ArraySchema<import("valibot").ObjectSchema<{
+        readonly scopeId: import("valibot").StringSchema<undefined>;
+        readonly contentType: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
+}, undefined>;
+export type DesignContentBulkSaveRequest = InferOutput<typeof DesignContentBulkSaveRequestSchema>;
+/**
+ * How far a delete reaches.
+ *
+ * - `none` — the row alone.
+ * - `prefix` — the row and every row whose `contentId` sits under it. Story
+ *   beats are addressed by the trail of choices taken to reach them, so this is
+ *   how discarding a branch takes its descendants with it.
+ * - `scope` — the row and everything scoped to it, transitively. Deleting a
+ *   world this way also removes its content, its story arcs, and their beats.
+ */
+export declare const DESIGN_CONTENT_CASCADES: readonly ["none", "prefix", "scope"];
+export declare const DesignContentCascadeSchema: import("valibot").PicklistSchema<readonly ["none", "prefix", "scope"], undefined>;
+export type DesignContentCascade = InferOutput<typeof DesignContentCascadeSchema>;
+/** Rows matching the listing, most recently edited first. */
+export declare const DesignContentListResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    items: import("valibot").OptionalSchema<import("valibot").ArraySchema<import("valibot").ObjectSchema<{
+        readonly contentType: import("valibot").StringSchema<undefined>;
+        readonly scopeId: import("valibot").StringSchema<undefined>;
+        readonly contentId: import("valibot").StringSchema<undefined>;
+        /** For display in a picker, so a list need not carry payloads to be readable. */
+        readonly name: import("valibot").StringSchema<undefined>;
+        readonly data: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+        readonly createdAt: import("valibot").StringSchema<undefined>;
+        readonly updatedAt: import("valibot").StringSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
+}, undefined>;
+export type DesignContentListResponse = InferOutput<typeof DesignContentListResponseSchema>;
+/** One row, absent when nothing is stored under that key. */
+export declare const DesignContentLoadResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    item: import("valibot").OptionalSchema<import("valibot").ObjectSchema<{
+        readonly contentType: import("valibot").StringSchema<undefined>;
+        readonly scopeId: import("valibot").StringSchema<undefined>;
+        readonly contentId: import("valibot").StringSchema<undefined>;
+        /** For display in a picker, so a list need not carry payloads to be readable. */
+        readonly name: import("valibot").StringSchema<undefined>;
+        readonly data: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+        readonly createdAt: import("valibot").StringSchema<undefined>;
+        readonly updatedAt: import("valibot").StringSchema<undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type DesignContentLoadResponse = InferOutput<typeof DesignContentLoadResponseSchema>;
+/** The saved row's id, echoed back. */
+export declare const DesignContentSaveResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    contentId: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+}, undefined>;
+export type DesignContentSaveResponse = InferOutput<typeof DesignContentSaveResponseSchema>;
+/** How many rows a bulk save wrote, and how many its `replace` sweep removed. */
+export declare const DesignContentBulkSaveResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    savedCount: import("valibot").OptionalSchema<import("valibot").NumberSchema<undefined>, undefined>;
+    removedCount: import("valibot").OptionalSchema<import("valibot").NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type DesignContentBulkSaveResponse = InferOutput<typeof DesignContentBulkSaveResponseSchema>;
+/** How many rows the delete removed — 0 when nothing matched. */
+export declare const DesignContentDeleteResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    deletedCount: import("valibot").OptionalSchema<import("valibot").NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type DesignContentDeleteResponse = InferOutput<typeof DesignContentDeleteResponseSchema>;
+//# sourceMappingURL=designContent.d.ts.map

package/dist/designContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"designContent.d.ts","sourceRoot":"","sources":["../src/designContent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAqD,MAAM,SAAS,CAAC;AAE9F;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oBAAoB,YAC/B,OAAO,EACP,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,OAAO,EACP,WAAW,EACX,MAAM,EACN,WAAW,EACX,YAAY,CACJ,CAAC;AAEX,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,yBAAyB;;;;IAIpC,iFAAiF;;;;;aAKjF,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,8BAA8B;;;;;;aAMzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE1F;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B;;;aAG1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAE5F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;aAG7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,WAAW,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAElG;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,YAAI,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAE5E,eAAO,MAAM,0BAA0B,mFAAoC,CAAC;AAE5E,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAElF,6DAA6D;AAC7D,eAAO,MAAM,+BAA+B;;;;;;;;QAlG1C,iFAAiF;;;;;;aAoGjF,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAE5F,6DAA6D;AAC7D,eAAO,MAAM,+BAA+B;;;;;;;;QAzG1C,iFAAiF;;;;;;aA2GjF,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAE5F,uCAAuC;AACvC,eAAO,MAAM,+BAA+B;;;;;aAE1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAE5F,iFAAiF;AACjF,eAAO,MAAM,mCAAmC;;;;;;aAG9C,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,WAAW,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEpG,iEAAiE;AACjE,eAAO,MAAM,iCAAiC;;;;;aAE5C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,WAAW,CAAC,OAAO,iCAAiC,CAAC,CAAC"}

package/dist/designContent.js

@@ -0,0 +1,195 @@
+import { createSuccessResponseSchema } from "@game-infra/api-schemas-core";
+import { array, number, object, optional, picklist, string } from "valibot";
+/**
+ * The transport for everything an author writes: worlds, the content written
+ * against them (locations, characters, skill definitions, lore entries), the
+ * story arcs chosen for a world, and the beats those arcs are told in.
+ *
+ * All of it is one shape — a keyed JSON payload, scoped to a parent, tagged
+ * with a type — so it is one resource rather than a family of near-identical
+ * ones. The service stores and indexes `data`; it never parses it. That is the
+ * same rule `GameEntitySaveRequestSchema` follows in `@game-infra/api-schemas-core`,
+ * and it is what lets a game's design vocabulary move without a contract bump.
+ *
+ * The shapes that go *inside* `data` are typed too — see `storyPayloads.ts` —
+ * but as schemas a client parses with, not as part of any endpoint.
+ */
+/**
+ * The scope of a row that has no parent. A world is scoped to nothing, but the
+ * key `(contentType, scopeId, contentId)` still needs three parts and a URL
+ * cannot carry an empty path segment, so unparented rows spell their scope `-`.
+ *
+ * @example
+ * ```ts
+ * import { ROOT_SCOPE, designContentLoadContract } from '@game-infra/story-schemas'
+ *
+ * designContentLoadContract.pathResolver({
+ *   gameId: 'g1', contentType: 'world', scopeId: ROOT_SCOPE, contentId: 'the-ash-reckoning',
+ * }) // '/games/g1/design-content/world/-/the-ash-reckoning'
+ * ```
+ */
+export const ROOT_SCOPE = "-";
+/**
+ * The vocabulary this contract was written against, and how each type is scoped:
+ *
+ * | Type                                                          | Scoped to    |
+ * | ------------------------------------------------------------- | ------------ |
+ * | `world`                                                       | {@link ROOT_SCOPE} |
+ * | `locations`, `characters`, `events`, `stats`, `skills`, `perks`, `resources`, `lore` | a world id |
+ * | `story-arc`                                                   | a world id   |
+ * | `story-node`                                                  | a story id   |
+ *
+ * `contentType` is a plain `string()` in every schema below — a game re-tightens
+ * it in its own validation layer — so treat this as the suggested set, not a
+ * closed one. The plural spellings match the collections of a design document;
+ * the singular ones name things there is one of.
+ *
+ * @example
+ * ```ts
+ * import { DESIGN_CONTENT_TYPES } from '@game-infra/story-schemas'
+ *
+ * DESIGN_CONTENT_TYPES.includes('story-node') // true
+ * ```
+ */
+export const DESIGN_CONTENT_TYPES = [
+    "world",
+    "locations",
+    "characters",
+    "events",
+    "stats",
+    "skills",
+    "perks",
+    "resources",
+    "lore",
+    "story-arc",
+    "story-node",
+];
+/**
+ * One row.
+ *
+ * `data` is present only when the request asked for it — a listing returns
+ * metadata by default, because a world picker needs names and counts, not
+ * every character's biography.
+ *
+ * @example
+ * ```ts
+ * import type { DesignContentRecord } from '@game-infra/story-schemas'
+ *
+ * const row: DesignContentRecord = {
+ *   contentType: 'characters',
+ *   scopeId: 'the-ash-reckoning',
+ *   contentId: 'tallow',
+ *   name: 'Tallow',
+ *   data: JSON.stringify({ id: 'tallow', name: 'Tallow', role: 'Drift-runner' }),
+ *   createdAt: '2026-08-29T09:00:00.000Z',
+ *   updatedAt: '2026-08-29T09:30:00.000Z',
+ * }
+ * ```
+ */
+export const DesignContentRecordSchema = object({
+    contentType: string(),
+    scopeId: string(),
+    contentId: string(),
+    /** For display in a picker, so a list need not carry payloads to be readable. */
+    name: string(),
+    data: optional(string()),
+    createdAt: string(),
+    updatedAt: string(),
+});
+/**
+ * Create or replace one row. Re-saving the same key keeps its `createdAt`.
+ *
+ * @example
+ * ```ts
+ * import type { DesignContentSaveRequest } from '@game-infra/story-schemas'
+ *
+ * const request: DesignContentSaveRequest = {
+ *   contentType: 'story-node',
+ *   scopeId: 'the-quiet-forge-answers',
+ *   contentId: 'root.take-the-tunnel',
+ *   name: 'take-the-tunnel',
+ *   data: JSON.stringify({ narration: 'The tunnel breathes out ash…', choices: [] }),
+ * }
+ * ```
+ */
+export const DesignContentSaveRequestSchema = object({
+    contentType: string(),
+    scopeId: string(),
+    contentId: string(),
+    name: string(),
+    data: string(),
+});
+/**
+ * What a bulk save clears before it writes.
+ *
+ * Omitting `contentType` sweeps the whole scope. Naming one sweeps just that
+ * type within it, which is the usual case: "these are all the locations for
+ * this world" has to remove the location the author deleted locally, or it
+ * would survive on the server forever.
+ */
+export const DesignContentReplaceScopeSchema = object({
+    scopeId: string(),
+    contentType: optional(string()),
+});
+/**
+ * Write many rows at once, optionally as a snapshot rather than a merge.
+ *
+ * A whole design document — the world plus every collection — lands in one
+ * request this way.
+ *
+ * @example
+ * ```ts
+ * import type { DesignContentBulkSaveRequest } from '@game-infra/story-schemas'
+ *
+ * const request: DesignContentBulkSaveRequest = {
+ *   items: [
+ *     {
+ *       contentType: 'locations',
+ *       scopeId: 'the-ash-reckoning',
+ *       contentId: 'cinderhold',
+ *       name: 'Cinderhold',
+ *       data: '{}',
+ *     },
+ *   ],
+ *   replace: [{ scopeId: 'the-ash-reckoning', contentType: 'locations' }],
+ * }
+ * ```
+ */
+export const DesignContentBulkSaveRequestSchema = object({
+    items: array(DesignContentSaveRequestSchema),
+    replace: optional(array(DesignContentReplaceScopeSchema)),
+});
+/**
+ * How far a delete reaches.
+ *
+ * - `none` — the row alone.
+ * - `prefix` — the row and every row whose `contentId` sits under it. Story
+ *   beats are addressed by the trail of choices taken to reach them, so this is
+ *   how discarding a branch takes its descendants with it.
+ * - `scope` — the row and everything scoped to it, transitively. Deleting a
+ *   world this way also removes its content, its story arcs, and their beats.
+ */
+export const DESIGN_CONTENT_CASCADES = ["none", "prefix", "scope"];
+export const DesignContentCascadeSchema = picklist(DESIGN_CONTENT_CASCADES);
+/** Rows matching the listing, most recently edited first. */
+export const DesignContentListResponseSchema = createSuccessResponseSchema({
+    items: optional(array(DesignContentRecordSchema)),
+});
+/** One row, absent when nothing is stored under that key. */
+export const DesignContentLoadResponseSchema = createSuccessResponseSchema({
+    item: optional(DesignContentRecordSchema),
+});
+/** The saved row's id, echoed back. */
+export const DesignContentSaveResponseSchema = createSuccessResponseSchema({
+    contentId: optional(string()),
+});
+/** How many rows a bulk save wrote, and how many its `replace` sweep removed. */
+export const DesignContentBulkSaveResponseSchema = createSuccessResponseSchema({
+    savedCount: optional(number()),
+    removedCount: optional(number()),
+});
+/** How many rows the delete removed — 0 when nothing matched. */
+export const DesignContentDeleteResponseSchema = createSuccessResponseSchema({
+    deletedCount: optional(number()),
+});
+//# sourceMappingURL=designContent.js.map

package/dist/designContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"designContent.js","sourceRoot":"","sources":["../src/designContent.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { DESIGN_CONTENT_CASCADES, DESIGN_CONTENT_TYPES, DesignContentBulkSaveRequestSchema, DesignContentBulkSaveResponseSchema, DesignContentCascadeSchema, DesignContentDeleteResponseSchema, DesignContentListResponseSchema, DesignContentLoadResponseSchema, DesignContentRecordSchema, DesignContentReplaceScopeSchema, DesignContentSaveRequestSchema, DesignContentSaveResponseSchema, ROOT_SCOPE, } from "./designContent.js";
+export type { DesignContentBulkSaveRequest, DesignContentBulkSaveResponse, DesignContentCascade, DesignContentDeleteResponse, DesignContentListResponse, DesignContentLoadResponse, DesignContentRecord, DesignContentReplaceScope, DesignContentSaveRequest, DesignContentSaveResponse, DesignContentType, } from "./designContent.js";
+export { ActivationDTOSchema, ChoiceDefinitionDTOSchema, ConsumableConditionDTOSchema, EncounterStageDTOSchema, PreconditionDTOSchema, STORY_BEAT_ORIGINS, StoryArcPayloadSchema, StoryBeatOriginSchema, StoryBeatPayloadSchema, WorldPayloadSchema, } from "./storyPayloads.js";
+export type { ActivationDTO, ChoiceDefinitionDTO, ConsumableConditionDTO, EncounterStageDTO, PreconditionDTO, StoryArcPayload, StoryBeatOrigin, StoryBeatPayload, WorldPayload, } from "./storyPayloads.js";
+export { NODE_ID_SEPARATOR, ROOT_NODE_ID, childStoryNodeId, isStoryNodeAtOrBelow, parentStoryNodeId, storyNodeChoiceIds, storyNodeDepth, storyNodeId, storyNodePath, } from "./nodePaths.js";
+export { designContentBulkSaveContract, designContentDeleteContract, designContentListContract, designContentLoadContract, designContentSaveContract, } from "./contracts.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,kCAAkC,EAClC,mCAAmC,EACnC,0BAA0B,EAC1B,iCAAiC,EACjC,+BAA+B,EAC/B,+BAA+B,EAC/B,yBAAyB,EACzB,+BAA+B,EAC/B,8BAA8B,EAC9B,+BAA+B,EAC/B,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+// Explicit barrel (no export *). Every public symbol is re-exported by name.
+// The transport: one keyed, scoped, typed JSON row for every kind of authored
+// design content.
+export { DESIGN_CONTENT_CASCADES, DESIGN_CONTENT_TYPES, DesignContentBulkSaveRequestSchema, DesignContentBulkSaveResponseSchema, DesignContentCascadeSchema, DesignContentDeleteResponseSchema, DesignContentListResponseSchema, DesignContentLoadResponseSchema, DesignContentRecordSchema, DesignContentReplaceScopeSchema, DesignContentSaveRequestSchema, DesignContentSaveResponseSchema, ROOT_SCOPE, } from "./designContent.js";
+// What goes inside a row's `data`. Not part of any endpoint — the service never
+// parses it — but shared so two clients agree on the shapes.
+//
+// A beat is an encounter stage and a branch is a choice: the event editor's own
+// DTOs, re-exported here so a story client needs one import rather than two.
+export { ActivationDTOSchema, ChoiceDefinitionDTOSchema, ConsumableConditionDTOSchema, EncounterStageDTOSchema, PreconditionDTOSchema, STORY_BEAT_ORIGINS, StoryArcPayloadSchema, StoryBeatOriginSchema, StoryBeatPayloadSchema, WorldPayloadSchema, } from "./storyPayloads.js";
+// Beat addressing, shared by the client that mints ids and the service that
+// sweeps subtrees.
+export { NODE_ID_SEPARATOR, ROOT_NODE_ID, childStoryNodeId, isStoryNodeAtOrBelow, parentStoryNodeId, storyNodeChoiceIds, storyNodeDepth, storyNodeId, storyNodePath, } from "./nodePaths.js";
+// Typed endpoint contracts (toad-contracts). Each contract carries its own
+// `pathResolver`; wire them into a client via @toad-contracts/frontend-http-client
+// and into a Hono service via @toad-contracts/hono.
+export { designContentBulkSaveContract, designContentDeleteContract, designContentListContract, designContentLoadContract, designContentSaveContract, } from "./contracts.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,8EAA8E;AAC9E,kBAAkB;AAClB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,kCAAkC,EAClC,mCAAmC,EACnC,0BAA0B,EAC1B,iCAAiC,EACjC,+BAA+B,EAC/B,+BAA+B,EAC/B,yBAAyB,EACzB,+BAA+B,EAC/B,8BAA8B,EAC9B,+BAA+B,EAC/B,UAAU,GACX,MAAM,oBAAoB,CAAC;AAe5B,gFAAgF;AAChF,6DAA6D;AAC7D,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAa5B,4EAA4E;AAC5E,mBAAmB;AACnB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,2EAA2E;AAC3E,mFAAmF;AACnF,oDAAoD;AACpD,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC"}

package/dist/nodePaths.d.ts

@@ -0,0 +1,107 @@
+/**
+ * How a beat is addressed.
+ *
+ * A story beat's identity is the trail of choices taken to reach it — nothing
+ * else. That is what makes "has this branch been travelled before?" a lookup
+ * rather than a search, and it is why both the client minting ids and the
+ * service sweeping subtrees have to agree on the spelling. They agree here.
+ *
+ * Two spellings, one meaning:
+ *
+ * - `nodeId` — `root`, then choice ids joined with `.`. It is the row's
+ *   `contentId`, and it travels as a single URL path segment
+ *   (`/design-content/story-node/:scopeId/:contentId`), which a slash would
+ *   split. The dot is also what `cascade=prefix` sweeps on.
+ * - `path` — the same trail joined with `/`, empty at the opening. This one is
+ *   for reading: it is what a breadcrumb shows.
+ */
+/** The opening beat of every story. */
+export declare const ROOT_NODE_ID = "root";
+/** Separator between choice ids inside a node id. */
+export declare const NODE_ID_SEPARATOR = ".";
+/**
+ * The id of the beat reached by taking `choiceIds` in order.
+ *
+ * @example
+ * ```ts
+ * import { storyNodeId } from '@game-infra/story-schemas'
+ *
+ * storyNodeId([]) // 'root'
+ * storyNodeId(['take-the-tunnel', 'follow-the-voice']) // 'root.take-the-tunnel.follow-the-voice'
+ * ```
+ */
+export declare function storyNodeId(choiceIds: readonly string[]): string;
+/**
+ * The readable trail for the same beat, empty at the opening.
+ *
+ * @example
+ * ```ts
+ * import { storyNodePath } from '@game-infra/story-schemas'
+ *
+ * storyNodePath(['take-the-tunnel', 'follow-the-voice']) // 'take-the-tunnel/follow-the-voice'
+ * ```
+ */
+export declare function storyNodePath(choiceIds: readonly string[]): string;
+/**
+ * The choice trail a node id encodes. The inverse of {@link storyNodeId}.
+ *
+ * @example
+ * ```ts
+ * import { storyNodeChoiceIds } from '@game-infra/story-schemas'
+ *
+ * storyNodeChoiceIds('root.take-the-tunnel') // ['take-the-tunnel']
+ * storyNodeChoiceIds('root') // []
+ * ```
+ */
+export declare function storyNodeChoiceIds(nodeId: string): readonly string[];
+/**
+ * The id of the beat one choice further on.
+ *
+ * @example
+ * ```ts
+ * import { childStoryNodeId } from '@game-infra/story-schemas'
+ *
+ * childStoryNodeId('root', 'take-the-tunnel') // 'root.take-the-tunnel'
+ * ```
+ */
+export declare function childStoryNodeId(parentNodeId: string, choiceId: string): string;
+/**
+ * The id of the beat this one branched from, or `undefined` at the opening.
+ *
+ * @example
+ * ```ts
+ * import { parentStoryNodeId } from '@game-infra/story-schemas'
+ *
+ * parentStoryNodeId('root.take-the-tunnel') // 'root'
+ * parentStoryNodeId('root') // undefined
+ * ```
+ */
+export declare function parentStoryNodeId(nodeId: string): string | undefined;
+/**
+ * How many choices deep a beat sits. The opening is 0.
+ *
+ * @example
+ * ```ts
+ * import { storyNodeDepth } from '@game-infra/story-schemas'
+ *
+ * storyNodeDepth('root.take-the-tunnel.follow-the-voice') // 2
+ * ```
+ */
+export declare function storyNodeDepth(nodeId: string): number;
+/**
+ * Whether `nodeId` sits at or below `ancestorId`. This is `cascade=prefix`,
+ * expressed for a client that holds the tree in memory.
+ *
+ * The separator is part of the test on purpose: `root.take` is not an ancestor
+ * of `root.taken`, however alike the two ids look.
+ *
+ * @example
+ * ```ts
+ * import { isStoryNodeAtOrBelow } from '@game-infra/story-schemas'
+ *
+ * isStoryNodeAtOrBelow('root.take.left', 'root.take') // true
+ * isStoryNodeAtOrBelow('root.taken', 'root.take') // false
+ * ```
+ */
+export declare function isStoryNodeAtOrBelow(nodeId: string, ancestorId: string): boolean;
+//# sourceMappingURL=nodePaths.d.ts.map

package/dist/nodePaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodePaths.d.ts","sourceRoot":"","sources":["../src/nodePaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,uCAAuC;AACvC,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAElE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAGpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAEhF"}