@company-semantics/contracts 0.101.0 → 0.102.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.101.0",
+  "version": "0.102.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/api/http/utils/resource-response.ts

@@ -0,0 +1,11 @@
+import type { ResourceResponse } from '../../../resource-response';
+
+/**
+ * Wrap resource data with version for cache invalidation.
+ * @param data - The resource data
+ * @param version - MUST be entity.updatedAt or DB row version. NEVER Date.now().
+ *   Using request time defeats invalidation — race conditions reappear.
+ */
+export function resourceResponse<T>(data: T, version: number): ResourceResponse<T> {
+  return { data, version };
+}

package/src/index.ts

@@ -536,3 +536,6 @@ export { ENVELOPE_TRANSITIONS } from './ci-envelope/index'
 // @see PRD-00321 for design rationale
 export type { ResourceKey, Action } from './resource-keys'
 export { resolveScope, toQueryKey, fromQueryKey, resourceRelationships, matchesResourceKey } from './resource-keys'
+
+// Resource response wrapper (typed versioning for cache invalidation)
+export type { ResourceResponse } from './resource-response'

package/src/resource-response.ts

@@ -0,0 +1,9 @@
+/**
+ * Standard response wrapper for resource endpoints.
+ * version MUST come from data source (entity.updatedAt), NEVER from request time (Date.now()).
+ * Using request time defeats invalidation — race conditions reappear.
+ */
+export type ResourceResponse<T> = {
+  data: T;
+  version: number;
+};