@sharpee/if-services 0.9.66-beta → 0.9.69-beta

package/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @sharpee/if-services - Runtime service interfaces for Sharpee Interactive Fiction Platform
+ *
+ * This package contains interfaces for runtime services that need access to
+ * the world model, separating them from the pure domain package.
+ */
+export * from './perception-service';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/if-services/src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,sBAAsB,CAAC"}

package/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * @sharpee/if-services - Runtime service interfaces for Sharpee Interactive Fiction Platform
+ *
+ * This package contains interfaces for runtime services that need access to
+ * the world model, separating them from the pure domain package.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Perception service interfaces
+__exportStar(require("./perception-service"), exports);
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/if-services/src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,gCAAgC;AAChC,uDAAqC"}

package/package.json

@@ -1,18 +1,9 @@
 {
   "name": "@sharpee/if-services",
-  "version": "0.9.66-beta",
+  "version": "0.9.69-beta",
   "description": "Runtime service interfaces for Sharpee Interactive Fiction Platform",
   "main": "./index.js",
   "types": "./index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "clean": "rimraf dist",
-    "test": "jest",
-    "build:npm": "tsc --outDir dist-npm"
-  },
-  "files": [
-    "dist-npm"
-  ],
   "keywords": [
     "sharpee",
     "interactive-fiction",

package/perception-service.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Perception service interface for Interactive Fiction
+ *
+ * Perception services filter events based on what the player can perceive.
+ * They sit between action execution and the text service, transforming
+ * events that describe things the player cannot perceive (due to darkness,
+ * blindness, etc.) into appropriate alternative events.
+ *
+ * @see ADR-069 Perception-Based Event Filtering
+ */
+import type { ISemanticEvent } from "./src/index";
+import type { IFEntity, IWorldModel } from "./src/index";
+/**
+ * Sense types for perception checks
+ */
+export type Sense = 'sight' | 'hearing' | 'smell' | 'touch';
+/**
+ * Reasons why perception might be blocked
+ */
+export type PerceptionBlockReason = 'darkness' | 'blindness' | 'blindfolded' | 'unknown';
+/**
+ * Data for a perception-blocked event
+ */
+export interface PerceptionBlockedData {
+    /** The original event type that was blocked */
+    originalType: string;
+    /** Why perception was blocked */
+    reason: PerceptionBlockReason;
+    /** Which sense was blocked */
+    sense: Sense;
+    /** Original event data (for debugging/logging) */
+    originalData?: unknown;
+}
+/**
+ * Service interface for filtering events based on player perception.
+ *
+ * The perception service determines what the player can perceive based on:
+ * - Environmental factors (darkness, noise, etc.)
+ * - Actor state (blindness, deafness, etc.)
+ * - Equipment (blindfold, earplugs, etc.)
+ *
+ * Events that describe things the player cannot perceive are transformed
+ * or removed before being sent to the text service.
+ *
+ * @see ADR-069 Perception-Based Event Filtering
+ */
+export interface IPerceptionService {
+    /**
+     * Filter events based on what the actor can perceive.
+     *
+     * @param events - Raw events from action execution
+     * @param actor - The perceiving actor (usually the player)
+     * @param world - The world model for checking environment state
+     * @returns Filtered/transformed events based on perception
+     */
+    filterEvents(events: ISemanticEvent[], actor: IFEntity, world: IWorldModel): ISemanticEvent[];
+    /**
+     * Check if an actor can perceive using a specific sense.
+     *
+     * @param actor - The perceiving actor
+     * @param location - The location being perceived
+     * @param world - The world model
+     * @param sense - Which sense to check (defaults to 'sight')
+     * @returns true if the actor can perceive, false otherwise
+     */
+    canPerceive(actor: IFEntity, location: IFEntity, world: IWorldModel, sense: Sense): boolean;
+}
+//# sourceMappingURL=perception-service.d.ts.map

package/perception-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perception-service.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/if-services/src/perception-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,WAAW,GACX,aAAa,GACb,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,8BAA8B;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,YAAY,CACV,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,WAAW,GACjB,cAAc,EAAE,CAAC;IAEpB;;;;;;;;OAQG;IACH,WAAW,CACT,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC;CACZ"}

package/perception-service.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Perception service interface for Interactive Fiction
+ *
+ * Perception services filter events based on what the player can perceive.
+ * They sit between action execution and the text service, transforming
+ * events that describe things the player cannot perceive (due to darkness,
+ * blindness, etc.) into appropriate alternative events.
+ *
+ * @see ADR-069 Perception-Based Event Filtering
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=perception-service.js.map

package/perception-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perception-service.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/if-services/src/perception-service.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}