@crowdedkingdoms/crowdyjs 17.14.0-dev.1 → 18.0.0-dev.1

package/dist/kit/blueprints/progression.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"progression.d.ts","sourceRoot":"","sources":["../../../src/kit/blueprints/progression.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,WAAW,CAAC;AAEnB,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC;;;OAGG;IACH,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,UAAU,SAAK,GAAG,gBAAgB,CAclE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,YAAY,CAoTd"}

package/dist/kit/blueprints/progression.js

@@ -1,324 +0,0 @@
-import { kitPolicyJson, ownerEqualsCaller, ownerMirrorProperty, toSnakeCase, trustedAuthorityFields, } from './core.js';
-/** Compute the type/function names a progression blueprint (and its runtime helper) uses. */
-export function progressionNames(typePrefix = '') {
-    const fnPrefix = typePrefix ? `${toSnakeCase(typePrefix)}_` : '';
-    return {
-        progressType: `${typePrefix}Progress`,
-        skillDefType: `${typePrefix}SkillDef`,
-        skillRankType: `${typePrefix}SkillRank`,
-        achievementDefType: `${typePrefix}AchievementDef`,
-        achievementUnlockType: `${typePrefix}AchievementUnlock`,
-        xpForLevelFn: `${fnPrefix}xp_for_level`,
-        grantXpFn: `${fnPrefix}grant_xp`,
-        buySkillFn: `${fnPrefix}spend_skill_point`,
-        unlockAchievementFn: `${fnPrefix}unlock_achievement`,
-        adjustRatingFn: `${fnPrefix}adjust_rating`,
-    };
-}
-/**
- * Blueprint for **character progression**: per-player `Progress` (xp / level /
- * skill points / rating), an admin `SkillDef` catalog with prerequisite
- * chains bought into per-player `SkillRank`s, threshold `AchievementDef`s
- * unlocked into `AchievementUnlock`s, and an ELO-style `adjust_rating` hook
- * for the match layer.
- *
- * Level-ups are computed server-side inside `grant_xp` using the `fn:`
- * helper pattern: the XP curve lives in ONE `internal` function
- * (`xp_for_level`, not directly invocable) that mutation expressions call as
- * `fn:xp_for_level(self.level + 1)`. Ordered mutations see earlier writes,
- * so xp is applied first, then the skill-point award, then the level bump —
- * one level per grant (call repeatedly for multi-level jumps).
- *
- * Runtime counterpart: `client.kit(appId).progression`.
- */
-export function progressionBlueprint(options = {}) {
-    const { typePrefix = '', xpAuthority = 'server', ratingAuthority = 'host', xpForLevelExpression = '100 * $level * $level', skillPointsPerLevel = 1, initialRating = 1000, ownerIdKind: kind = 'int', } = options;
-    const names = progressionNames(typePrefix);
-    const levelUpCondition = `self.xp >= fn:${names.xpForLevelFn}(self.level + 1)`;
-    const propertyDefinitions = [
-        ownerMirrorProperty(names.progressType, kind),
-        {
-            containerTypeName: names.progressType,
-            key: 'xp',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: 'Lifetime experience points.',
-        },
-        {
-            containerTypeName: names.progressType,
-            key: 'level',
-            valueType: 'int',
-            defaultValueJson: '1',
-            description: 'Current level, advanced server-side by grant_xp.',
-        },
-        {
-            containerTypeName: names.progressType,
-            key: 'skill_points',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: 'Unspent skill points (earned on level-up).',
-        },
-        {
-            containerTypeName: names.progressType,
-            key: 'rating',
-            valueType: 'int',
-            defaultValueJson: String(initialRating),
-            description: 'Competitive rating (ELO-style), adjusted by the match layer.',
-        },
-        {
-            containerTypeName: names.skillDefType,
-            key: 'skill_id',
-            valueType: 'string',
-            description: 'Stable skill identifier.',
-        },
-        {
-            containerTypeName: names.skillDefType,
-            key: 'cost',
-            valueType: 'int',
-            defaultValueJson: '1',
-            description: 'Skill points per rank.',
-        },
-        {
-            containerTypeName: names.skillDefType,
-            key: 'requires_skill_id',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: 'Prerequisite skill_id (empty for none); rank ≥ 1 required.',
-        },
-        {
-            containerTypeName: names.skillDefType,
-            key: 'max_rank',
-            valueType: 'int',
-            defaultValueJson: '1',
-            description: 'Maximum purchasable rank.',
-        },
-        ownerMirrorProperty(names.skillRankType, kind),
-        {
-            containerTypeName: names.skillRankType,
-            key: 'skill_id',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: 'The skill this rank row tracks.',
-        },
-        {
-            containerTypeName: names.skillRankType,
-            key: 'rank',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: 'Current rank (0 = not learned).',
-        },
-        {
-            containerTypeName: names.achievementDefType,
-            key: 'achievement_id',
-            valueType: 'string',
-            description: 'Stable achievement identifier.',
-        },
-        {
-            containerTypeName: names.achievementDefType,
-            key: 'threshold',
-            valueType: 'int',
-            defaultValueJson: '0',
-            description: 'Total xp required to unlock.',
-        },
-        ownerMirrorProperty(names.achievementUnlockType, kind),
-        {
-            containerTypeName: names.achievementUnlockType,
-            key: 'achievement_id',
-            valueType: 'string',
-            defaultValueJson: '""',
-            description: 'The achievement this unlock row tracks.',
-        },
-        {
-            containerTypeName: names.achievementUnlockType,
-            key: 'unlocked',
-            valueType: 'bool',
-            defaultValueJson: 'false',
-            description: 'True once the threshold check has passed (idempotent).',
-        },
-    ];
-    const functions = [
-        {
-            name: names.xpForLevelFn,
-            containerTypeName: names.progressType,
-            returnType: 'int',
-            invokeScope: 'internal',
-            parameters: [
-                {
-                    name: 'level',
-                    valueType: 'int',
-                    required: true,
-                    description: 'The level whose total-xp requirement to compute.',
-                },
-            ],
-            mutations: [],
-            returnExpression: xpForLevelExpression,
-            description: 'The XP curve: total xp required to reach $level. Internal-only; read via fn: calls from grant_xp (the fn: helper pattern).',
-        },
-        {
-            name: names.grantXpFn,
-            containerTypeName: names.progressType,
-            returnType: 'int',
-            parameters: [
-                {
-                    name: 'amount',
-                    valueType: 'int',
-                    required: true,
-                    description: 'XP to add (negative values are ignored).',
-                },
-            ],
-            mutations: [
-                { target: 'self', property: 'xp', expression: 'self.xp + max(0, $amount)' },
-                {
-                    target: 'self',
-                    property: 'skill_points',
-                    expression: `self.skill_points + if(${levelUpCondition}, ${skillPointsPerLevel}, 0)`,
-                },
-                {
-                    target: 'self',
-                    property: 'level',
-                    expression: `if(${levelUpCondition}, self.level + 1, self.level)`,
-                },
-            ],
-            returnExpression: 'self.level',
-            ...trustedAuthorityFields(xpAuthority),
-            description: 'Trusted XP grant: adds xp, then awards skill points and bumps the level when the fn:xp_for_level curve is crossed (one level per grant).',
-        },
-        {
-            name: names.buySkillFn,
-            containerTypeName: names.skillRankType,
-            returnType: 'int',
-            parameters: [
-                {
-                    name: 'progress_id',
-                    valueType: 'container_ref',
-                    required: true,
-                    description: "The caller's Progress container (pays the skill points).",
-                },
-                {
-                    name: 'def_id',
-                    valueType: 'container_ref',
-                    required: true,
-                    description: 'The SkillDef being bought.',
-                },
-                {
-                    name: 'prereq_id',
-                    valueType: 'container_ref',
-                    required: true,
-                    description: "The caller's SkillRank for the prerequisite skill (pass this rank container itself when the skill has no prerequisite).",
-                },
-            ],
-            mutations: [
-                {
-                    target: 'ref($progress_id)',
-                    property: 'skill_points',
-                    expression: 'ref($progress_id).skill_points - ref($def_id).cost',
-                },
-                { target: 'self', property: 'rank', expression: 'self.rank + 1' },
-            ],
-            returnExpression: 'self.rank',
-            invokePolicyJson: kitPolicyJson({
-                type: 'condition',
-                expression: [
-                    ownerEqualsCaller('self.owner_user_id', kind),
-                    ownerEqualsCaller('ref($progress_id).owner_user_id', kind),
-                    'self.skill_id == ref($def_id).skill_id',
-                    'ref($progress_id).skill_points >= ref($def_id).cost',
-                    'self.rank < ref($def_id).max_rank',
-                    `if(ref($def_id).requires_skill_id == "", true, ref($prereq_id).skill_id == ref($def_id).requires_skill_id && ref($prereq_id).rank >= 1 && ${ownerEqualsCaller('ref($prereq_id).owner_user_id', kind)})`,
-                ].join(' && '),
-            }),
-            description: 'Buy one rank of a skill: point cost, max rank, and the prerequisite chain are all checked server-side; the spend and the rank-up are one transaction.',
-        },
-        {
-            name: names.unlockAchievementFn,
-            containerTypeName: names.achievementUnlockType,
-            returnType: 'bool',
-            parameters: [
-                {
-                    name: 'progress_id',
-                    valueType: 'container_ref',
-                    required: true,
-                    description: "The caller's Progress container (xp threshold source).",
-                },
-                {
-                    name: 'def_id',
-                    valueType: 'container_ref',
-                    required: true,
-                    description: 'The AchievementDef whose threshold to check.',
-                },
-            ],
-            mutations: [{ target: 'self', property: 'unlocked', expression: 'true' }],
-            returnExpression: 'self.unlocked',
-            invokePolicyJson: kitPolicyJson({
-                type: 'condition',
-                expression: [
-                    ownerEqualsCaller('self.owner_user_id', kind),
-                    ownerEqualsCaller('ref($progress_id).owner_user_id', kind),
-                    'self.achievement_id == ref($def_id).achievement_id',
-                    'ref($progress_id).xp >= ref($def_id).threshold',
-                ].join(' && '),
-            }),
-            description: 'Unlock an achievement once its xp threshold is met (idempotent: re-invoking just re-writes true).',
-        },
-        {
-            name: names.adjustRatingFn,
-            containerTypeName: names.progressType,
-            returnType: 'int',
-            parameters: [
-                {
-                    name: 'delta',
-                    valueType: 'int',
-                    required: true,
-                    description: 'Signed rating change (an ELO delta computed by the match layer).',
-                },
-            ],
-            mutations: [
-                {
-                    target: 'self',
-                    property: 'rating',
-                    expression: 'max(0, self.rating + $delta)',
-                },
-            ],
-            returnExpression: 'self.rating',
-            ...trustedAuthorityFields(ratingAuthority),
-            description: 'Trusted rating adjustment (host-gated by default) — wired from kit.matches match results.',
-        },
-    ];
-    return {
-        name: names.progressType,
-        containerTypes: [
-            {
-                typeName: names.progressType,
-                displayName: names.progressType,
-                instantiableBy: 'member',
-                description: 'Per-player progression: xp, level, skill points, rating.',
-            },
-            {
-                typeName: names.skillDefType,
-                displayName: names.skillDefType,
-                instantiableBy: 'admin',
-                description: 'Studio skill catalog row (cost, prerequisite, max rank).',
-            },
-            {
-                typeName: names.skillRankType,
-                displayName: names.skillRankType,
-                instantiableBy: 'member',
-                description: "A player's purchased rank of one skill.",
-            },
-            {
-                typeName: names.achievementDefType,
-                displayName: names.achievementDefType,
-                instantiableBy: 'admin',
-                description: 'Studio achievement catalog row (xp threshold).',
-            },
-            {
-                typeName: names.achievementUnlockType,
-                displayName: names.achievementUnlockType,
-                instantiableBy: 'member',
-                description: "A player's unlock state for one achievement.",
-            },
-        ],
-        propertyDefinitions,
-        functions,
-    };
-}

package/dist/kit/blueprints/quests.d.ts

@@ -1,72 +0,0 @@
-import { type KitBlueprint, type KitOwnerIdKind, type KitTrustedAuthority } from './core.js';
-/** An event-driven quest advance: bump matching QuestProgress rows on a model event. */
-export interface QuestAdvanceSpec {
-    /** Automation name (unique per app), e.g. `'advance-on-craft'`. */
-    name: string;
-    /** Only progress rows of this quest advance. */
-    questId: string;
-    /** The gameplay event that advances the quest (e.g. `consume_stack` invoked). */
-    onEvent: 'function_invoked' | 'property_changed' | 'container_created';
-    functionName?: string;
-    containerTypeName?: string;
-    propertyKey?: string;
-    /**
-     * `property_changed` only: which writes advance the quest. Kit progress
-     * properties are written by functions (`advance_quest`, the daily reset),
-     * not by client `setProperty` calls, so watching one needs `'function'` or
-     * `'any'` — the default `'direct'` would never match.
-     */
-    writeSource?: 'direct' | 'function' | 'any';
-    debounceMs?: number;
-    /** Progress added per event. Defaults to 1. */
-    amount?: number;
-    /** Progress rows advanced per event. Defaults to 8. */
-    maxTargets?: number;
-}
-/** Options for {@link questsBlueprint}. */
-export interface QuestsBlueprintOptions {
-    /** Prefix for the type/function names. Defaults to none. */
-    typePrefix?: string;
-    /**
-     * Who may advance quest progress. Defaults to `'server'`; use
-     * `'automation'` when driving progress purely through `advanceOn` event
-     * automations. Never plain players — they would complete their own quests.
-     */
-    advanceAuthority?: KitTrustedAuthority;
-    /**
-     * The wallet currency property that `claim_reward` pays `reward_gold`
-     * into. Defaults to `'gold'` (compose with the economy blueprint's
-     * wallet).
-     */
-    currencyProperty?: string;
-    /** Cron for the daily reset automation. Defaults to `'0 0 * * *'` (UTC midnight). */
-    dailyResetCron?: string;
-    /** Event automations that advance quests from gameplay functions. */
-    advanceOn?: QuestAdvanceSpec[];
-    /** Owner-mirror typing (see the kit convention). Defaults to `'int'`. */
-    ownerIdKind?: KitOwnerIdKind;
-}
-/** Names derived by {@link questsBlueprint} for a given prefix. */
-export interface QuestsNames {
-    defType: string;
-    progressType: string;
-    advanceFn: string;
-    claimFn: string;
-    resetFn: string;
-    dailyResetAutomation: string;
-}
-/** Compute the type/function names a quests blueprint (and its runtime helper) uses. */
-export declare function questsNames(typePrefix?: string): QuestsNames;
-/**
- * Blueprint for **quests**: an admin `QuestDef` catalog (objective count +
- * reward spec + daily flag) and per-player `QuestProgress` rows. Progress
- * advances through trusted calls or event automations on your gameplay
- * functions; `claim_reward` marks the progress claimed AND grants the item
- * and currency rewards through `container_ref` params in ONE transaction
- * (composing with the inventory stack and economy wallet types); a **cron
- * automation** resets daily quests at midnight.
- *
- * Runtime counterpart: `client.kit(appId).quests`.
- */
-export declare function questsBlueprint(options?: QuestsBlueprintOptions): KitBlueprint;
-//# sourceMappingURL=quests.d.ts.map

package/dist/kit/blueprints/quests.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"quests.d.ts","sourceRoot":"","sources":["../../../src/kit/blueprints/quests.ts"],"names":[],"mappings":"AAIA,OAAO,EAQL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,WAAW,CAAC;AAEnB,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,yEAAyE;IACzE,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,UAAU,SAAK,GAAG,WAAW,CAUxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,YAAY,CAmRlF"}