@aura3d/scripting 1.0.6

package/dist/BehaviorRegistry.js

@@ -0,0 +1,17 @@
+export class BehaviorRegistry {
+    factories = new Map();
+    register(type, factory) {
+        if (this.factories.has(type)) {
+            throw new Error(`Behavior type already registered: ${type}`);
+        }
+        this.factories.set(type, factory);
+    }
+    create(type) {
+        const factory = this.factories.get(type);
+        if (!factory) {
+            throw new Error(`Unknown behavior type: ${type}`);
+        }
+        return factory();
+    }
+}
+//# sourceMappingURL=BehaviorRegistry.js.map

package/dist/BehaviorRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BehaviorRegistry.js","sourceRoot":"","sources":["../../../../packages/scripting/src/BehaviorRegistry.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,gBAAgB;IACV,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEhE,QAAQ,CAAC,IAAY,EAAE,OAAwB;QAC7C,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/BehaviorSystem.d.ts

@@ -0,0 +1,26 @@
+import type { Behavior, BehaviorPhase } from "./Behavior";
+import type { BehaviorHost } from "./BehaviorHost";
+export interface BehaviorError {
+    readonly phase: BehaviorPhase;
+    readonly behavior: Behavior;
+    readonly error: unknown;
+}
+export interface BehaviorSystemUpdateOptions {
+    readonly deltaSeconds?: number;
+    readonly fixedDeltaSeconds?: number;
+}
+export declare class BehaviorSystem {
+    readonly errors: BehaviorError[];
+    private readonly hosts;
+    private readonly started;
+    private readonly services;
+    registerHost(host: BehaviorHost): void;
+    unregisterHost(host: BehaviorHost): void;
+    setService(name: string, value: unknown): void;
+    fixedUpdate(options?: BehaviorSystemUpdateOptions): Promise<void>;
+    update(options?: BehaviorSystemUpdateOptions): Promise<void>;
+    private runStart;
+    private runPhase;
+    private invoke;
+}
+//# sourceMappingURL=BehaviorSystem.d.ts.map

package/dist/BehaviorSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BehaviorSystem.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/BehaviorSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,CAAM;IAEtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAEvD,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAItC,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIxC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIxC,WAAW,CAAC,OAAO,GAAE,2BAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,MAAM,CAAC,OAAO,GAAE,2BAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;YAKxD,QAAQ;YAiBR,QAAQ;YAgBR,MAAM;CA0BrB"}

package/dist/BehaviorSystem.js

@@ -0,0 +1,76 @@
+import { ScriptContext } from "./ScriptContext.js";
+export class BehaviorSystem {
+    errors = [];
+    hosts = new Set();
+    started = new WeakSet();
+    services = new Map();
+    registerHost(host) {
+        this.hosts.add(host);
+    }
+    unregisterHost(host) {
+        this.hosts.delete(host);
+    }
+    setService(name, value) {
+        this.services.set(name, value);
+    }
+    async fixedUpdate(options = {}) {
+        await this.runPhase("fixed", options);
+    }
+    async update(options = {}) {
+        await this.runStart(options);
+        await this.runPhase("update", options);
+    }
+    async runStart(options) {
+        for (const host of [...this.hosts]) {
+            if (host.isDestroyed) {
+                this.hosts.delete(host);
+                continue;
+            }
+            for (const behavior of host.list()) {
+                if (behavior.enabled === false || this.started.has(behavior)) {
+                    continue;
+                }
+                this.started.add(behavior);
+                await this.invoke("start", behavior, host, options);
+            }
+        }
+    }
+    async runPhase(phase, options) {
+        for (const host of [...this.hosts]) {
+            if (host.isDestroyed) {
+                this.hosts.delete(host);
+                continue;
+            }
+            for (const behavior of host.list()) {
+                if (behavior.enabled === false) {
+                    continue;
+                }
+                await this.invoke(phase, behavior, host, options);
+            }
+        }
+    }
+    async invoke(phase, behavior, host, options) {
+        const context = new ScriptContext({
+            phase,
+            deltaSeconds: options.deltaSeconds,
+            fixedDeltaSeconds: options.fixedDeltaSeconds,
+            target: host.target,
+            services: this.services
+        });
+        try {
+            if (phase === "start") {
+                await behavior.onStart?.(context);
+            }
+            else if (phase === "fixed") {
+                await behavior.onFixedUpdate?.(context);
+            }
+            else if (phase === "update") {
+                await behavior.onUpdate?.(context);
+            }
+        }
+        catch (error) {
+            this.errors.push({ phase, behavior, error });
+        }
+    }
+}
+//# sourceMappingURL=BehaviorSystem.js.map

package/dist/BehaviorSystem.js.map

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

package/dist/BehaviorTree.d.ts

@@ -0,0 +1,75 @@
+export type BehaviorTreeStatus = "success" | "failure" | "running";
+export type BlackboardValue = number | string | boolean | readonly unknown[] | Record<string, unknown> | null | undefined;
+export interface BlackboardChange {
+    readonly key: string;
+    readonly value: BlackboardValue;
+    readonly previous: BlackboardValue;
+    readonly version: number;
+}
+export interface BehaviorTreeContext {
+    readonly blackboard: Blackboard;
+    readonly deltaSeconds: number;
+    readonly depth: number;
+}
+export interface BehaviorTreeTickResult {
+    readonly status: BehaviorTreeStatus;
+    readonly tickCount: number;
+    readonly trace: readonly string[];
+    readonly blackboardVersion: number;
+}
+export declare abstract class BehaviorTreeNode {
+    readonly name: string;
+    status: BehaviorTreeStatus;
+    running: boolean;
+    constructor(name: string);
+    abstract tick(context: BehaviorTreeContext): BehaviorTreeStatus;
+    reset(): void;
+}
+export declare class Blackboard {
+    readonly parent?: Blackboard | undefined;
+    private readonly values;
+    private readonly changes;
+    private localVersion;
+    constructor(parent?: Blackboard | undefined);
+    get version(): number;
+    set(key: string, value: BlackboardValue): void;
+    get<T extends BlackboardValue = BlackboardValue>(key: string, fallback?: T): T;
+    has(key: string): boolean;
+    snapshot(): Record<string, BlackboardValue>;
+    changeLog(): readonly BlackboardChange[];
+}
+export declare class BehaviorAction extends BehaviorTreeNode {
+    private readonly action;
+    constructor(name: string, action: (context: BehaviorTreeContext) => BehaviorTreeStatus);
+    tick(context: BehaviorTreeContext): BehaviorTreeStatus;
+}
+export declare class BehaviorCondition extends BehaviorTreeNode {
+    private readonly condition;
+    constructor(name: string, condition: (context: BehaviorTreeContext) => boolean);
+    tick(context: BehaviorTreeContext): BehaviorTreeStatus;
+}
+export declare class BehaviorSequence extends BehaviorTreeNode {
+    readonly children: readonly BehaviorTreeNode[];
+    private currentIndex;
+    constructor(name: string, children: readonly BehaviorTreeNode[]);
+    tick(context: BehaviorTreeContext): BehaviorTreeStatus;
+    reset(): void;
+}
+export declare class BehaviorSelector extends BehaviorTreeNode {
+    readonly children: readonly BehaviorTreeNode[];
+    private currentIndex;
+    constructor(name: string, children: readonly BehaviorTreeNode[]);
+    tick(context: BehaviorTreeContext): BehaviorTreeStatus;
+    reset(): void;
+}
+export declare class BehaviorTree {
+    readonly root: BehaviorTreeNode;
+    readonly blackboard: Blackboard;
+    private tickCounter;
+    private lastTrace;
+    constructor(root: BehaviorTreeNode, blackboard?: Blackboard);
+    tick(deltaSeconds: number): BehaviorTreeTickResult;
+    reset(): void;
+    private tickNode;
+}
+//# sourceMappingURL=BehaviorTree.d.ts.map

package/dist/BehaviorTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BehaviorTree.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/BehaviorTree.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AACnE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAE1H,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,8BAAsB,gBAAgB;aAIR,IAAI,EAAE,MAAM;IAHjC,MAAM,EAAE,kBAAkB,CAAa;IACvC,OAAO,UAAS;gBAEK,IAAI,EAAE,MAAM;IAExC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;IAE/D,KAAK,IAAI,IAAI;CAId;AAED,qBAAa,UAAU;aAKO,MAAM,CAAC,EAAE,UAAU;IAJ/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoF;IAC3G,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,YAAY,CAAK;gBAEG,MAAM,CAAC,EAAE,UAAU,YAAA;IAE/C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI;IAO9C,GAAG,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC;IAO9E,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAK3C,SAAS,IAAI,SAAS,gBAAgB,EAAE;CAGzC;AAED,qBAAa,cAAe,SAAQ,gBAAgB;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAArC,IAAI,EAAE,MAAM,EAAmB,MAAM,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,kBAAkB;IAIvG,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;CAMvD;AAED,qBAAa,iBAAkB,SAAQ,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAxC,IAAI,EAAE,MAAM,EAAmB,SAAS,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO;IAI/F,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;CAIvD;AAED,qBAAa,gBAAiB,SAAQ,gBAAgB;aAGV,QAAQ,EAAE,SAAS,gBAAgB,EAAE;IAF/E,OAAO,CAAC,YAAY,CAAK;gBAEb,IAAI,EAAE,MAAM,EAAkB,QAAQ,EAAE,SAAS,gBAAgB,EAAE;IAI/E,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;IAoB7C,KAAK,IAAI,IAAI;CAKvB;AAED,qBAAa,gBAAiB,SAAQ,gBAAgB;aAGV,QAAQ,EAAE,SAAS,gBAAgB,EAAE;IAF/E,OAAO,CAAC,YAAY,CAAK;gBAEb,IAAI,EAAE,MAAM,EAAkB,QAAQ,EAAE,SAAS,gBAAgB,EAAE;IAI/E,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;IAoB7C,KAAK,IAAI,IAAI;CAKvB;AAED,qBAAa,YAAY;aAIK,IAAI,EAAE,gBAAgB;aAAkB,UAAU;IAH9E,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAgB;gBAEL,IAAI,EAAE,gBAAgB,EAAkB,UAAU,aAAmB;IAEjG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,sBAAsB;IAYlD,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,QAAQ;CAUjB"}

package/dist/BehaviorTree.js

@@ -0,0 +1,204 @@
+export class BehaviorTreeNode {
+    name;
+    status = "failure";
+    running = false;
+    constructor(name) {
+        this.name = name;
+    }
+    reset() {
+        this.status = "failure";
+        this.running = false;
+    }
+}
+export class Blackboard {
+    parent;
+    values = new Map();
+    changes = [];
+    localVersion = 0;
+    constructor(parent) {
+        this.parent = parent;
+    }
+    get version() {
+        return this.localVersion;
+    }
+    set(key, value) {
+        const previous = this.get(key);
+        this.localVersion += 1;
+        this.values.set(key, { value, version: this.localVersion });
+        this.changes.push({ key, value, previous, version: this.localVersion });
+    }
+    get(key, fallback) {
+        const local = this.values.get(key);
+        if (local)
+            return local.value;
+        if (this.parent?.has(key))
+            return this.parent.get(key, fallback);
+        return fallback;
+    }
+    has(key) {
+        return this.values.has(key) || this.parent?.has(key) === true;
+    }
+    snapshot() {
+        const inherited = this.parent?.snapshot() ?? {};
+        return { ...inherited, ...Object.fromEntries([...this.values].map(([key, entry]) => [key, entry.value])) };
+    }
+    changeLog() {
+        return [...this.changes];
+    }
+}
+export class BehaviorAction extends BehaviorTreeNode {
+    action;
+    constructor(name, action) {
+        super(name);
+        this.action = action;
+    }
+    tick(context) {
+        this.running = true;
+        this.status = this.action(context);
+        if (this.status !== "running")
+            this.running = false;
+        return this.status;
+    }
+}
+export class BehaviorCondition extends BehaviorTreeNode {
+    condition;
+    constructor(name, condition) {
+        super(name);
+        this.condition = condition;
+    }
+    tick(context) {
+        this.status = this.condition(context) ? "success" : "failure";
+        return this.status;
+    }
+}
+export class BehaviorSequence extends BehaviorTreeNode {
+    children;
+    currentIndex = 0;
+    constructor(name, children) {
+        super(name);
+        this.children = children;
+    }
+    tick(context) {
+        this.running = true;
+        while (this.currentIndex < this.children.length) {
+            const child = this.children[this.currentIndex];
+            const status = child.tick({ ...context, depth: context.depth + 1 });
+            if (status === "failure") {
+                this.reset();
+                return "failure";
+            }
+            if (status === "running") {
+                this.status = "running";
+                return "running";
+            }
+            this.currentIndex += 1;
+        }
+        this.reset();
+        this.status = "success";
+        return "success";
+    }
+    reset() {
+        super.reset();
+        this.currentIndex = 0;
+        for (const child of this.children)
+            child.reset();
+    }
+}
+export class BehaviorSelector extends BehaviorTreeNode {
+    children;
+    currentIndex = 0;
+    constructor(name, children) {
+        super(name);
+        this.children = children;
+    }
+    tick(context) {
+        this.running = true;
+        while (this.currentIndex < this.children.length) {
+            const child = this.children[this.currentIndex];
+            const status = child.tick({ ...context, depth: context.depth + 1 });
+            if (status === "success") {
+                this.reset();
+                return "success";
+            }
+            if (status === "running") {
+                this.status = "running";
+                return "running";
+            }
+            this.currentIndex += 1;
+        }
+        this.reset();
+        this.status = "failure";
+        return "failure";
+    }
+    reset() {
+        super.reset();
+        this.currentIndex = 0;
+        for (const child of this.children)
+            child.reset();
+    }
+}
+export class BehaviorTree {
+    root;
+    blackboard;
+    tickCounter = 0;
+    lastTrace = [];
+    constructor(root, blackboard = new Blackboard()) {
+        this.root = root;
+        this.blackboard = blackboard;
+    }
+    tick(deltaSeconds) {
+        this.tickCounter += 1;
+        this.lastTrace = [];
+        const status = this.tickNode(this.root, { blackboard: this.blackboard, deltaSeconds, depth: 0 });
+        return {
+            status,
+            tickCount: this.tickCounter,
+            trace: [...this.lastTrace],
+            blackboardVersion: this.blackboard.version
+        };
+    }
+    reset() {
+        this.root.reset();
+        this.lastTrace = [];
+        this.tickCounter = 0;
+    }
+    tickNode(node, context) {
+        const status = node.tick({
+            ...context,
+            blackboard: new TracingBlackboard(context.blackboard, (key, value) => {
+                this.lastTrace.push(`${node.name}:${key}=${String(value)}`);
+            })
+        });
+        this.lastTrace.push(`${node.name}:${status}`);
+        return status;
+    }
+}
+class TracingBlackboard extends Blackboard {
+    target;
+    onSet;
+    constructor(target, onSet) {
+        super();
+        this.target = target;
+        this.onSet = onSet;
+    }
+    get version() {
+        return this.target.version;
+    }
+    set(key, value) {
+        this.target.set(key, value);
+        this.onSet(key, value);
+    }
+    get(key, fallback) {
+        return this.target.get(key, fallback);
+    }
+    has(key) {
+        return this.target.has(key);
+    }
+    snapshot() {
+        return this.target.snapshot();
+    }
+    changeLog() {
+        return this.target.changeLog();
+    }
+}
+//# sourceMappingURL=BehaviorTree.js.map

package/dist/BehaviorTree.js.map

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

package/dist/CloudServiceFixtures.d.ts

@@ -0,0 +1,81 @@
+export type CloudFixtureServiceStatus = "offline-cache" | "queued" | "synced" | "simulated-match" | "blocked";
+export interface CloudServiceFixtureOptions {
+    readonly seed?: number;
+    readonly playerId?: string;
+    readonly score?: number;
+    readonly offlineMode?: boolean;
+    readonly sessionSeconds?: number;
+}
+export interface CloudServiceFixture {
+    readonly source: "origin-master-cloud-services-adapted";
+    readonly services: {
+        readonly authentication: {
+            readonly provider: "guest";
+            readonly authenticated: false;
+            readonly offlineUserId: string;
+            readonly tokenIssued: false;
+            readonly status: CloudFixtureServiceStatus;
+        };
+        readonly cloudSave: {
+            readonly saveId: "runtime-progress";
+            readonly version: number;
+            readonly checksum: string;
+            readonly queuedUploads: number;
+            readonly conflictResolution: "last-write-wins" | "merge" | "manual";
+            readonly status: CloudFixtureServiceStatus;
+        };
+        readonly achievements: {
+            readonly unlocked: readonly string[];
+            readonly inProgress: readonly {
+                readonly id: string;
+                readonly progress: number;
+            }[];
+            readonly totalPoints: number;
+            readonly status: CloudFixtureServiceStatus;
+        };
+        readonly leaderboard: {
+            readonly id: "runtime-score";
+            readonly score: number;
+            readonly rank: number;
+            readonly timeFrame: "daily" | "weekly" | "all-time";
+            readonly cachedEntries: number;
+            readonly status: CloudFixtureServiceStatus;
+        };
+        readonly remoteConfig: {
+            readonly activated: true;
+            readonly abTestGroup: "control" | "variant-a" | "variant-b";
+            readonly parameterCount: number;
+            readonly difficultyScale: number;
+            readonly eventMultiplier: number;
+            readonly status: CloudFixtureServiceStatus;
+        };
+        readonly matchmaking: {
+            readonly queue: "casual-runtime";
+            readonly region: "local";
+            readonly ticketId: string;
+            readonly estimatedWaitMs: number;
+            readonly matchedPlayers: number;
+            readonly status: CloudFixtureServiceStatus;
+        };
+        readonly contentDelivery: {
+            readonly manifestId: "runtime-content";
+            readonly assetCount: number;
+            readonly cacheHits: number;
+            readonly integrityHashes: readonly string[];
+            readonly status: CloudFixtureServiceStatus;
+        };
+    };
+    readonly productionReadiness: {
+        readonly cloudServiceTelemetry: true;
+        readonly offlineQueueTelemetry: true;
+        readonly remoteConfigTelemetry: true;
+        readonly leaderboardTelemetry: true;
+        readonly matchmakingTelemetry: true;
+        readonly contentDeliveryTelemetry: true;
+    };
+    readonly blockedClaims: readonly string[];
+    readonly claimBoundary: string;
+    readonly hash: string;
+}
+export declare function sampleCloudServiceFixture(options?: CloudServiceFixtureOptions): CloudServiceFixture;
+//# sourceMappingURL=CloudServiceFixtures.d.ts.map

package/dist/CloudServiceFixtures.d.ts.map

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

package/dist/CloudServiceFixtures.js

@@ -0,0 +1,144 @@
+export function sampleCloudServiceFixture(options = {}) {
+    const seed = normalizeSeed(options.seed ?? 0xc10d);
+    const playerId = normalizePlayerId(options.playerId ?? "external-parity-runtime-player");
+    const score = positiveInteger(options.score ?? 12_400, "score");
+    const sessionSeconds = positiveInteger(options.sessionSeconds ?? 180, "sessionSeconds");
+    const offlineMode = options.offlineMode ?? true;
+    const abTestGroup = seededChoice(seed, ["control", "variant-a", "variant-b"]);
+    const difficultyScale = Number((0.86 + seededUnit(seed ^ 0x55a5) * 0.24).toFixed(3));
+    const eventMultiplier = Number((1 + Math.min(0.5, sessionSeconds / 1800)).toFixed(3));
+    const version = 3 + Math.floor(seededUnit(seed ^ 0x911) * 6);
+    const savePayload = JSON.stringify({ playerId, score, sessionSeconds, version });
+    const cloudSaveChecksum = stableHash(savePayload);
+    const achievements = [
+        { id: "first-run", points: 10, progress: 1 },
+        { id: "collector", points: 25, progress: Math.min(1, score / 20_000) },
+        { id: "speed-clear", points: 50, progress: Math.min(1, sessionSeconds <= 240 ? 1 : 240 / sessionSeconds) }
+    ];
+    const unlocked = achievements.filter((achievement) => achievement.progress >= 1).map((achievement) => achievement.id);
+    const inProgress = achievements.filter((achievement) => achievement.progress < 1).map((achievement) => ({
+        id: achievement.id,
+        progress: Number(achievement.progress.toFixed(3))
+    }));
+    const rank = Math.max(1, Math.round(5000 / Math.max(1, score / 500)));
+    const integrityHashes = [
+        stableHash(`runtime-content:${seed}:arena`),
+        stableHash(`runtime-content:${seed}:hero`),
+        stableHash(`runtime-content:${seed}:config`)
+    ];
+    const status = offlineMode ? "offline-cache" : "queued";
+    const fixture = {
+        source: "origin-master-cloud-services-adapted",
+        services: {
+            authentication: {
+                provider: "guest",
+                authenticated: false,
+                offlineUserId: `guest-${stableHash(playerId).slice(0, 6)}`,
+                tokenIssued: false,
+                status
+            },
+            cloudSave: {
+                saveId: "runtime-progress",
+                version,
+                checksum: cloudSaveChecksum,
+                queuedUploads: offlineMode ? 1 : 0,
+                conflictResolution: "last-write-wins",
+                status: offlineMode ? "queued" : "synced"
+            },
+            achievements: {
+                unlocked,
+                inProgress,
+                totalPoints: achievements.filter((achievement) => achievement.progress >= 1).reduce((sum, achievement) => sum + achievement.points, 0),
+                status
+            },
+            leaderboard: {
+                id: "runtime-score",
+                score,
+                rank,
+                timeFrame: "weekly",
+                cachedEntries: 5 + Math.floor(seededUnit(seed ^ 0x7717) * 8),
+                status
+            },
+            remoteConfig: {
+                activated: true,
+                abTestGroup,
+                parameterCount: 4,
+                difficultyScale,
+                eventMultiplier,
+                status
+            },
+            matchmaking: {
+                queue: "casual-runtime",
+                region: "local",
+                ticketId: `ticket-${stableHash(`${playerId}:${score}`).slice(0, 8)}`,
+                estimatedWaitMs: Math.round(1500 + seededUnit(seed ^ 0x4d47) * 3000),
+                matchedPlayers: 2,
+                status: "simulated-match"
+            },
+            contentDelivery: {
+                manifestId: "runtime-content",
+                assetCount: integrityHashes.length,
+                cacheHits: offlineMode ? integrityHashes.length : Math.max(1, integrityHashes.length - 1),
+                integrityHashes,
+                status
+            }
+        },
+        productionReadiness: {
+            cloudServiceTelemetry: true,
+            offlineQueueTelemetry: true,
+            remoteConfigTelemetry: true,
+            leaderboardTelemetry: true,
+            matchmakingTelemetry: true,
+            contentDeliveryTelemetry: true
+        },
+        blockedClaims: [
+            "real cloud authentication backend",
+            "production cloud-save conflict resolution",
+            "hosted CDN/content-delivery parity",
+            "real multiplayer matchmaking service",
+            "Unity Gaming Services parity",
+            "Unreal Online Services parity",
+            "privacy/compliance/security certification"
+        ],
+        claimBoundary: "This fixture ports old cloud-service concepts into deterministic local telemetry. It does not contact a backend, issue real auth tokens, upload saves, submit leaderboards, run CDN delivery, create multiplayer matches, or claim Unity Gaming Services or Unreal Online Services parity."
+    };
+    return {
+        ...fixture,
+        hash: stableHash(JSON.stringify(fixture))
+    };
+}
+function normalizeSeed(seed) {
+    if (!Number.isInteger(seed) || seed < 0)
+        throw new Error("seed must be a non-negative integer.");
+    return seed >>> 0;
+}
+function normalizePlayerId(playerId) {
+    const trimmed = playerId.trim();
+    if (trimmed.length === 0)
+        throw new Error("playerId must not be empty.");
+    return trimmed;
+}
+function positiveInteger(value, name) {
+    if (!Number.isInteger(value) || value <= 0)
+        throw new Error(`${name} must be a positive integer.`);
+    return value;
+}
+function seededChoice(seed, values) {
+    return values[Math.min(values.length - 1, Math.floor(seededUnit(seed) * values.length))];
+}
+function seededUnit(seed) {
+    let value = seed >>> 0;
+    value ^= value << 13;
+    value ^= value >>> 17;
+    value ^= value << 5;
+    return (value >>> 0) / 0xffffffff;
+}
+function stableHash(value) {
+    let hash = 2166136261;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 16777619);
+    }
+    return (hash >>> 0).toString(16).padStart(8, "0");
+}
+//# sourceMappingURL=CloudServiceFixtures.js.map