@fastly/compute-js-context 0.4.2 → 0.5.1

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [unreleased]
 
+## [0.5.1] - 2025-10-14
+
+### Fixed
+
+- Updated README
+
+## [0.5.0] - 2025-10-14
+
+### Changed
+
+- BREAKING: Make build context proxy create the context internally
+
+### Added
+
+- Make proxy object possible to extend an existing object
+
 ## [0.4.2] - 2025-10-08
 
 ### Fixed
@@ -25,7 +41,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial public release
 
-[unreleased]: https://github.com/fastly/compute-js-context/compare/v0.4.2...HEAD
+[unreleased]: https://github.com/fastly/compute-js-context/compare/v0.5.1...HEAD
+[0.5.1]: https://github.com/fastly/compute-js-context/compare/v0.5.0...v0.5.1
+[0.5.0]: https://github.com/fastly/compute-js-context/compare/v0.4.2...v0.5.0
 [0.4.2]: https://github.com/fastly/compute-js-context/compare/v0.4.1...v0.4.2
 [0.4.1]: https://github.com/fastly/compute-js-context/compare/v0.2.0...v0.4.1
 [0.2.0]: https://github.com/fastly/compute-js-context/releases/tag/v0.2.0

package/README.md

@@ -80,7 +80,7 @@ Then, pass these definitions to `buildContextProxy()`.
 
 ```typescript
 /// <reference types="@fastly/js-compute" />
-import { createContext, buildContextProxy, type BindingsDefs } from '@fastly/compute-js-context';
+import { buildContextProxy, type BindingsDefs } from '@fastly/compute-js-context';
 
 // Define your application's bindings
 const bindingsDefs = {
@@ -99,10 +99,8 @@ type Bindings = ContextProxy<typeof bindingsDefs>;
 
 addEventListener('fetch', (event) => event.respondWith(handler(event)));
 async function handler(event: FetchEvent): Promise<Response> {
-  const ctx = createContext();
-  
   // Create the typed environment
-  const bindings: Bindings = buildContextProxy(ctx, bindingsDefs);
+  const bindings: Bindings = buildContextProxy(bindingsDefs);
 
   // Now use your custom bindings!
   const asset = await bindings.assets?.get('/index.html');

package/build/proxy.d.ts

@@ -4,7 +4,6 @@ import type { ConfigStore } from 'fastly:config-store';
 import type { KVStore } from 'fastly:kv-store';
 import type { Logger } from 'fastly:logger';
 import type { SecretStore } from 'fastly:secret-store';
-import type { Context } from './index.js';
 type Def<T extends string> = T | `${T}:${string}`;
 type Defs<T extends string> = T extends string ? Def<T> : never;
 declare const BindingStringToContextKeyMapping: {
@@ -32,6 +31,7 @@ export type ResourceInstance<T> = T extends Def<infer K extends keyof BindingStr
 export type ContextProxy<T extends BindingsDefs> = keyof T extends never ? Record<string, never> : {
     [K in keyof T]: ResourceInstance<T[K]>;
 };
-export declare function buildContextProxy<T extends BindingsDefs>(context: Context, bindingsDefs: T): ContextProxy<T>;
+export declare function buildContextProxyOn<TTarget extends object, T extends BindingsDefs>(target: TTarget, bindingsDefs: T): (TTarget & ContextProxy<T>);
+export declare function buildContextProxy<T extends BindingsDefs>(bindingsDefs: T): ContextProxy<T>;
 export {};
 //# sourceMappingURL=proxy.d.ts.map

package/build/proxy.js

@@ -2,6 +2,7 @@
  * Copyright Fastly, Inc.
  * Licensed under the MIT license. See LICENSE file for details.
  */
+import { createContext } from './index.js';
 const BindingStringToContextKeyMapping = {
     Acl: 'ACLS',
     Backend: 'BACKENDS',
@@ -25,10 +26,10 @@ function getResourceName(key, typeName) {
     const [, seg,] = typeName.split(':');
     return seg ?? key;
 }
-export function buildContextProxy(context, bindingsDefs) {
-    const target = {};
+export function buildContextProxyOn(target, bindingsDefs) {
+    const context = createContext();
     const getEntry = (key) => {
-        if (typeof key !== "string") {
+        if (typeof key !== "string" || !(key in bindingsDefs)) {
             return undefined;
         }
         const typeName = bindingsDefs[key];
@@ -45,12 +46,28 @@ export function buildContextProxy(context, bindingsDefs) {
         return contextEntry[resourceName];
     };
     const handler = {
-        get(_, key) {
-            return getEntry(key);
+        get(target, key, receiver) {
+            if (typeof key !== "string") {
+                return Reflect.get(target, key, receiver);
+            }
+            const entry = getEntry(key);
+            if (entry !== undefined) {
+                return entry;
+            }
+            return Reflect.get(target, key, receiver);
         },
-        has(_, key) {
-            return getEntry(key) !== undefined;
+        has(target, key) {
+            if (typeof key !== "string") {
+                return Reflect.has(target, key);
+            }
+            if (getEntry(key) !== undefined) {
+                return true;
+            }
+            return Reflect.has(target, key);
         },
     };
     return new Proxy(target, handler);
 }
+export function buildContextProxy(bindingsDefs) {
+    return buildContextProxyOn({}, bindingsDefs);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fastly/compute-js-context",
-  "version": "0.4.2",
+  "version": "0.5.1",
   "description": "Surfaces Fastly Compute environment as a context object",
   "license": "MIT",
   "repository": {