@stone-js/resources 0.8.18 → 0.8.19

package/dist/index.js

@@ -1,6 +1,111 @@
 import { RuntimeError, hasMetadata, getMetadata, classDecoratorLegacyWrapper, setMetadata, SERVICE_KEY, addBlueprint, methodDecoratorLegacyWrapper, addMetadata } from '@stone-js/core';
 import { cloneValue } from '@stone-js/config';
 
+/**
+ * Returns a copy of `object` without any `undefined` values (so conditional fields simply vanish).
+ *
+ * @param object - The object to clean.
+ * @returns A copy without undefined values.
+ */
+function stripUndefined(object) {
+    const out = {};
+    for (const key of Object.keys(object)) {
+        if (object[key] !== undefined) {
+            out[key] = object[key];
+        }
+    }
+    return out;
+}
+/**
+ * Keeps only the given keys of an object (ignoring keys that are absent).
+ *
+ * @param object - The source object.
+ * @param keys - The keys to keep.
+ * @returns A new object with only those keys.
+ */
+function only(object, keys) {
+    const set = new Set(keys);
+    const out = {};
+    for (const key of Object.keys(object)) {
+        if (set.has(key)) {
+            out[key] = object[key];
+        }
+    }
+    return out;
+}
+/**
+ * Returns a copy of an object without the given keys.
+ *
+ * @param object - The source object.
+ * @param keys - The keys to drop.
+ * @returns A new object without those keys.
+ */
+function except(object, keys) {
+    const set = new Set(keys);
+    const out = {};
+    for (const key of Object.keys(object)) {
+        if (!set.has(key)) {
+            out[key] = object[key];
+        }
+    }
+    return out;
+}
+/**
+ * Applies a sparse fieldset to an output: strips undefined, then narrows to the requested fields
+ * (when any were requested).
+ *
+ * @param output - The transformed output.
+ * @param fields - The requested fields (optional).
+ * @returns The filtered output.
+ */
+function applyFields(output, fields) {
+    const clean = stripUndefined(output);
+    return fields !== undefined && fields.length > 0 ? only(clean, fields) : clean;
+}
+/**
+ * Build a {@link ResourceContext} from an incoming event.
+ *
+ * The parameter names are configuration, not convention: an API that already answers `?view=` or
+ * `?only=` keeps its own vocabulary instead of gaining a second one. Defaults are `fields`, `include`
+ * and `view`.
+ *
+ * The authenticated principal is read too, because deciding what a caller may see is the most common
+ * reason two callers get different shapes — and a resource that cannot see who is asking has to be
+ * told by the handler, which is exactly the plumbing this module exists to remove.
+ *
+ * Agnostic: the event only needs `get(key)`.
+ *
+ * @param event - Anything with `get(key)` (an `IncomingHttpEvent`, a URL search wrapper, …).
+ * @param blueprint - The blueprint carrying the parameter names, when there is one.
+ * @param extra - Extra context to merge in.
+ * @returns The resource context.
+ */
+function contextFromEvent(event, blueprint, extra = {}) {
+    const names = blueprint?.get('stone.resources.params', {}) ?? {};
+    const fragment = event.get(names.fragment ?? 'view', '');
+    return {
+        ...extra,
+        event,
+        // `getUser()` and not `get('user')`: the principal is set through a resolver, not as metadata, so
+        // the generic accessor never reaches it. Duck-typed, because the kernel is agnostic and an event
+        // without a user simply has no such method.
+        principal: event.getUser?.(),
+        fields: splitCsv(event.get(names.fields ?? 'fields', '')),
+        include: splitCsv(event.get(names.include ?? 'include', '')),
+        fragment: fragment.length > 0 ? fragment : undefined
+    };
+}
+/**
+ * Split a comma-separated string into a trimmed, non-empty list (or `undefined` when empty).
+ *
+ * @param value - The CSV string.
+ * @returns The list, or `undefined`.
+ */
+function splitCsv(value) {
+    const parts = String(value).split(',').map((part) => part.trim()).filter((part) => part.length > 0);
+    return parts.length > 0 ? parts : undefined;
+}
+
 /**
  * Runs a schema and reports what it said.
  *
@@ -142,111 +247,6 @@ class ContractChecker {
     }
 }
 
-/**
- * Returns a copy of `object` without any `undefined` values (so conditional fields simply vanish).
- *
- * @param object - The object to clean.
- * @returns A copy without undefined values.
- */
-function stripUndefined(object) {
-    const out = {};
-    for (const key of Object.keys(object)) {
-        if (object[key] !== undefined) {
-            out[key] = object[key];
-        }
-    }
-    return out;
-}
-/**
- * Keeps only the given keys of an object (ignoring keys that are absent).
- *
- * @param object - The source object.
- * @param keys - The keys to keep.
- * @returns A new object with only those keys.
- */
-function only(object, keys) {
-    const set = new Set(keys);
-    const out = {};
-    for (const key of Object.keys(object)) {
-        if (set.has(key)) {
-            out[key] = object[key];
-        }
-    }
-    return out;
-}
-/**
- * Returns a copy of an object without the given keys.
- *
- * @param object - The source object.
- * @param keys - The keys to drop.
- * @returns A new object without those keys.
- */
-function except(object, keys) {
-    const set = new Set(keys);
-    const out = {};
-    for (const key of Object.keys(object)) {
-        if (!set.has(key)) {
-            out[key] = object[key];
-        }
-    }
-    return out;
-}
-/**
- * Applies a sparse fieldset to an output: strips undefined, then narrows to the requested fields
- * (when any were requested).
- *
- * @param output - The transformed output.
- * @param fields - The requested fields (optional).
- * @returns The filtered output.
- */
-function applyFields(output, fields) {
-    const clean = stripUndefined(output);
-    return fields !== undefined && fields.length > 0 ? only(clean, fields) : clean;
-}
-/**
- * Build a {@link ResourceContext} from an incoming event.
- *
- * The parameter names are configuration, not convention: an API that already answers `?view=` or
- * `?only=` keeps its own vocabulary instead of gaining a second one. Defaults are `fields`, `include`
- * and `view`.
- *
- * The authenticated principal is read too, because deciding what a caller may see is the most common
- * reason two callers get different shapes — and a resource that cannot see who is asking has to be
- * told by the handler, which is exactly the plumbing this module exists to remove.
- *
- * Agnostic: the event only needs `get(key)`.
- *
- * @param event - Anything with `get(key)` (an `IncomingHttpEvent`, a URL search wrapper, …).
- * @param blueprint - The blueprint carrying the parameter names, when there is one.
- * @param extra - Extra context to merge in.
- * @returns The resource context.
- */
-function contextFromEvent(event, blueprint, extra = {}) {
-    const names = blueprint?.get('stone.resources.params', {}) ?? {};
-    const fragment = event.get(names.fragment ?? 'view', '');
-    return {
-        ...extra,
-        event,
-        // `getUser()` and not `get('user')`: the principal is set through a resolver, not as metadata, so
-        // the generic accessor never reaches it. Duck-typed, because the kernel is agnostic and an event
-        // without a user simply has no such method.
-        principal: event.getUser?.(),
-        fields: splitCsv(event.get(names.fields ?? 'fields', '')),
-        include: splitCsv(event.get(names.include ?? 'include', '')),
-        fragment: fragment.length > 0 ? fragment : undefined
-    };
-}
-/**
- * Split a comma-separated string into a trimmed, non-empty list (or `undefined` when empty).
- *
- * @param value - The CSV string.
- * @returns The list, or `undefined`.
- */
-function splitCsv(value) {
-    const parts = String(value).split(',').map((part) => part.trim()).filter((part) => part.length > 0);
-    return parts.length > 0 ? parts : undefined;
-}
-
 /**
  * Raised when what a handler produced does not match the schema its resource published.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stone-js/resources",
-  "version": "0.8.18",
+  "version": "0.8.19",
   "description": "Framework-agnostic API resources for Stone.js. Shape what your domain exposes — sparse fieldsets, conditional fields, includes and envelopes — decoupled from controllers, the same on backend and frontend.",
   "author": "Mr. Stone <evensstone@gmail.com>",
   "license": "MIT",
@@ -58,7 +58,7 @@
     "typescript": "^5.6.3",
     "vitest": "^3.2.4",
     "zod": "^3.25.76",
-    "@stone-js/service-container": "0.8.18"
+    "@stone-js/service-container": "0.8.19"
   },
   "ts-standard": {
     "globals": [
@@ -71,10 +71,10 @@
     ]
   },
   "dependencies": {
-    "@stone-js/config": "0.8.18"
+    "@stone-js/config": "0.8.19"
   },
   "peerDependencies": {
-    "@stone-js/core": "0.8.18"
+    "@stone-js/core": "0.8.19"
   },
   "scripts": {
     "lint": "ts-standard src",