@typewirets/inversify 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 TypeWireTS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -0,0 +1,183 @@
+# TypeWire Inversify Adapter
+
+The InversifyJS adapter for TypeWire, allowing you to use TypeWire with InversifyJS containers.
+
+## Installation
+
+```bash
+npm install @typewirets/inversify inversify
+```
+
+## Usage
+
+The adapter allows you to use TypeWire definitions with an existing InversifyJS container:
+
+```typescript
+import { Container } from 'inversify';
+import { createInversifyAdapter } from '@typewirets/inversify';
+import { typeWireOf } from '@typewirets/core';
+
+// Define your services
+class Logger {
+  log(message: string): void {
+    console.log(`[LOG] ${message}`);
+  }
+}
+
+class UserService {
+  constructor(private logger: Logger) {}
+
+  getUser(id: string): void {
+    this.logger.log(`Getting user with id: ${id}`);
+    // Implementation...
+  }
+}
+
+// Create an Inversify container
+const container = new Container();
+
+// Create an adapter to use with TypeWire
+const adapter = createInversifyAdapter(container);
+
+// Create TypeWire definitions
+const loggerWire = typeWireOf({
+  token: 'Logger',
+  creator: () => new Logger()
+});
+
+const userServiceWire = typeWireOf({
+  token: 'UserService',
+  creator: (ctx) => new UserService(loggerWire.getInstance(ctx))
+});
+
+// Register with the Inversify container (using async/await)
+async function setup() {
+  await loggerWire.apply(adapter);
+  await userServiceWire.apply(adapter);
+  
+  // Resolve using the TypeWire API
+  const userService = userServiceWire.getInstance(adapter);
+  userService.getUser('123');
+}
+
+setup();
+```
+
+## Using with Existing Inversify Code
+
+You can also use TypeWire alongside existing Inversify bindings:
+
+```typescript
+import { Container, injectable, inject } from 'inversify';
+import { createInversifyAdapter, adaptToResolutionContext } from '@typewirets/inversify';
+import { typeWireOf, typedSymbolOf } from '@typewirets/core';
+
+// Existing Inversify setup
+const TYPES = {
+  Database: Symbol.for('Database')
+};
+
+@injectable()
+class Database {
+  connect() { /* ... */ }
+}
+
+// TypeWire definition
+const loggerWire = typeWireOf({
+  token: 'Logger',
+  creator: () => new Logger()
+});
+
+// Hybrid service that uses both
+const userRepoWire = typeWireOf({
+  token: 'UserRepository',
+  creator: (ctx) => {
+    // Get TypeWire dependency
+    const logger = loggerWire.getInstance(ctx);
+    
+    // Get Inversify dependency (through the adapter)
+    const db = ctx.get(typedSymbolOf('Database'));
+    
+    return new UserRepository(logger, db);
+  }
+});
+
+// Setup (using async/await)
+async function setup() {
+  const container = new Container();
+  container.bind(TYPES.Database).to(Database).inSingletonScope();
+
+  const adapter = createInversifyAdapter(container);
+  await loggerWire.apply(adapter);
+  await userRepoWire.apply(adapter);
+  
+  // Use the repository
+  const repo = userRepoWire.getInstance(adapter);
+}
+
+setup();
+```
+
+## Adapter Functions
+
+The adapter provides three main functions:
+
+### adaptToResolutionContext
+
+Creates a TypeWire `ResolutionContext` adapter for an Inversify container:
+
+```typescript
+import { adaptToResolutionContext } from '@typewirets/inversify';
+
+const resolutionContext = adaptToResolutionContext(container);
+const logger = loggerWire.getInstance(resolutionContext);
+```
+
+### adaptToBindingContext
+
+Creates a TypeWire `BindingContext` adapter for an Inversify container:
+
+```typescript
+import { adaptToBindingContext } from '@typewirets/inversify';
+
+const bindingContext = adaptToBindingContext(container);
+await loggerWire.apply(bindingContext);  // Note the await
+```
+
+### createInversifyAdapter
+
+Creates a combined adapter that implements both `ResolutionContext` and `BindingContext`:
+
+```typescript
+import { createInversifyAdapter } from '@typewirets/inversify';
+
+const adapter = createInversifyAdapter(container);
+await loggerWire.apply(adapter);  // Note the await
+const logger = loggerWire.getInstance(adapter);
+```
+
+## Scope Mapping and Behavior
+
+The adapter automatically maps TypeWire scopes to Inversify binding scopes:
+
+| TypeWire Scope | Inversify Scope    |
+|----------------|-------------------|
+| 'singleton'    | 'Singleton'       |
+| 'transient'    | 'Transient'       |
+| 'request'      | 'Request'         |
+
+### Important Notes About Scoping:
+
+- **Singleton and Transient Scopes**: These work as expected in all scenarios and are the recommended scopes to use with TypeWire. See the [core package documentation](../core/README.md) for more details on our recommended scoping strategy.
+
+- **Request Scope**: While supported for compatibility, this requires special attention:
+  - Request scope in Inversify is designed to work with container hierarchies
+  - For request scope to work correctly, you must:
+    1. Use Inversify's container hierarchy properly (typically with a parent container and child containers per request)
+    2. Ensure your components using request-scoped dependencies are managed by Inversify (usually with `@injectable()` decorators)
+  - In standalone applications (non-web) or when not using container hierarchies, request scope may behave like transient scope
+  - We generally recommend using singleton scopes with explicit parameter passing instead of relying on request scopes
+
+## License
+
+MIT 

package/dist/cjs/index.d.ts

@@ -0,0 +1,114 @@
+import type { AnyTypeSymbol, AnyTypeWire, BindingContext, TypeSymbol, ResolutionContext as TypeWireResolutionContext } from "@typewirets/core";
+import type { BindingScope, Container } from "inversify";
+/**
+ * Converts a TypeWire scope string to the equivalent InversifyJS BindingScope.
+ *
+ * @param scope - The TypeWire scope string (e.g., 'singleton', 'transient', 'request')
+ * @returns The equivalent InversifyJS BindingScope or undefined if no conversion is possible
+ *
+ * @example
+ * ```typescript
+ * // Convert a TypeWire scope to InversifyJS scope
+ * const inversifyScope = adoptScope('singleton'); // returns 'Singleton'
+ * ```
+ */
+export declare function adoptScope(scope?: string): BindingScope | undefined;
+/**
+ * Adapter class that provides both TypeWire ResolutionContext and BindingContext
+ * interfaces on top of an InversifyJS container.
+ *
+ * This adapter allows TypeWire definitions to work with an existing InversifyJS
+ * container, providing a bridge between the two dependency injection systems.
+ *
+ * @example
+ * ```typescript
+ * const container = new Container();
+ * const adapter = new InversifyAdapter(container);
+ *
+ * // Now you can use TypeWire with your InversifyJS container
+ * await serviceWire.apply(adapter);
+ * const service = await serviceWire.getInstance(adapter);
+ * ```
+ */
+export declare class InversifyAdapter implements TypeWireResolutionContext, BindingContext {
+    #private;
+    readonly container: Container;
+    /**
+     * Set of symbols for which instances have been loaded/initialized.
+     * Used to track which singleton instances have already been created.
+     */
+    private readonly loaded;
+    /**
+     * Set of symbols that represent singleton-scoped dependencies.
+     */
+    private readonly singletons;
+    /**
+     * Creates a new InversifyAdapter for the specified container.
+     *
+     * @param container - The InversifyJS container to adapt
+     */
+    constructor(container: Container);
+    /**
+     * Gets an instance of type T synchronously.
+     * For singleton-scoped dependencies, also tracks that they have been loaded.
+     *
+     * @template T - The type of instance to get
+     * @param typeSymbol - The type symbol identifying the dependency
+     * @returns An instance of type T
+     * @throws Error if the dependency cannot be resolved synchronously
+     */
+    getSync<T>(typeSymbol: AnyTypeSymbol): T;
+    /**
+     * Gets an instance of type T asynchronously.
+     * For singleton-scoped dependencies, also tracks that they have been loaded.
+     *
+     * @template T - The type of instance to get
+     * @param typeSymbol - The type symbol identifying the dependency
+     * @returns A promise that resolves to an instance of type T
+     * @throws Error if the dependency is not found
+     */
+    get<T>(typeSymbol: TypeSymbol<T>): Promise<T>;
+    /**
+     * Binds a TypeWire to the InversifyJS container.
+     * Configures the binding with the appropriate scope and creator function.
+     *
+     * @param typeWire - The TypeWire to bind
+     */
+    bind(typeWire: AnyTypeWire): void | Promise<void>;
+    /**
+     * Removes a binding from the InversifyJS container.
+     * Also removes any tracking information for the binding.
+     *
+     * @param typeSymbol - The type symbol identifying the binding to remove
+     * @returns A promise that resolves when the unbinding is complete
+     */
+    unbind(typeSymbol: AnyTypeSymbol): Promise<void>;
+    /**
+     * Checks if a binding exists in the InversifyJS container.
+     *
+     * @param typeSymbol - The type symbol to check
+     * @returns True if the binding exists, false otherwise
+     */
+    isBound(typeSymbol: AnyTypeSymbol): boolean;
+}
+/**
+ * Creates an adapter that provides both TypeWire ResolutionContext and BindingContext
+ * interfaces using an InversifyJS container.
+ *
+ * This is a convenience function for creating an InversifyAdapter.
+ *
+ * @param container - The InversifyJS container to adapt
+ * @returns An object implementing both TypeWire interfaces
+ *
+ * @example
+ * ```typescript
+ * const container = new Container();
+ * const adapter = createInversifyAdapter(container);
+ *
+ * // Now you can use TypeWire with your InversifyJS container
+ * await serviceWire.apply(adapter);
+ * const service = await serviceWire.getInstance(adapter);
+ * ```
+ */
+export declare function createInversifyAdapter(container: Container): TypeWireResolutionContext & BindingContext;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACV,iBAAiB,IAAI,yBAAyB,EAC/C,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAanE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBACX,YAAW,yBAAyB,EAAE,cAAc;;IAkBxC,QAAQ,CAAC,SAAS,EAAE,SAAS;IAhBzC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IAEjD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IAErD;;;;OAIG;gBACkB,SAAS,EAAE,SAAS;IAYzC;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,aAAa,GAAG,CAAC;IAUxC;;;;;;;;OAQG;IACG,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAUnD;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjD;;;;;;OAMG;IACG,MAAM,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtD;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO;CAG5C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,GACnB,yBAAyB,GAAG,cAAc,CAE5C"}

package/dist/cjs/index.js

@@ -0,0 +1,182 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _InversifyAdapter_instances, _InversifyAdapter_isSingleton;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InversifyAdapter = void 0;
+exports.adoptScope = adoptScope;
+exports.createInversifyAdapter = createInversifyAdapter;
+/**
+ * Converts a TypeWire scope string to the equivalent InversifyJS BindingScope.
+ *
+ * @param scope - The TypeWire scope string (e.g., 'singleton', 'transient', 'request')
+ * @returns The equivalent InversifyJS BindingScope or undefined if no conversion is possible
+ *
+ * @example
+ * ```typescript
+ * // Convert a TypeWire scope to InversifyJS scope
+ * const inversifyScope = adoptScope('singleton'); // returns 'Singleton'
+ * ```
+ */
+function adoptScope(scope) {
+    if (!scope) {
+        return "Singleton";
+    }
+    switch (scope.toLowerCase()) {
+        case "singleton":
+            return "Singleton";
+        case "transient":
+            return "Transient";
+        case "request":
+            return "Request";
+    }
+}
+/**
+ * Adapter class that provides both TypeWire ResolutionContext and BindingContext
+ * interfaces on top of an InversifyJS container.
+ *
+ * This adapter allows TypeWire definitions to work with an existing InversifyJS
+ * container, providing a bridge between the two dependency injection systems.
+ *
+ * @example
+ * ```typescript
+ * const container = new Container();
+ * const adapter = new InversifyAdapter(container);
+ *
+ * // Now you can use TypeWire with your InversifyJS container
+ * await serviceWire.apply(adapter);
+ * const service = await serviceWire.getInstance(adapter);
+ * ```
+ */
+class InversifyAdapter {
+    /**
+     * Creates a new InversifyAdapter for the specified container.
+     *
+     * @param container - The InversifyJS container to adapt
+     */
+    constructor(container) {
+        _InversifyAdapter_instances.add(this);
+        this.container = container;
+        /**
+         * Set of symbols for which instances have been loaded/initialized.
+         * Used to track which singleton instances have already been created.
+         */
+        this.loaded = new Set();
+        /**
+         * Set of symbols that represent singleton-scoped dependencies.
+         */
+        this.singletons = new Set();
+    }
+    /**
+     * Gets an instance of type T synchronously.
+     * For singleton-scoped dependencies, also tracks that they have been loaded.
+     *
+     * @template T - The type of instance to get
+     * @param typeSymbol - The type symbol identifying the dependency
+     * @returns An instance of type T
+     * @throws Error if the dependency cannot be resolved synchronously
+     */
+    getSync(typeSymbol) {
+        if (!__classPrivateFieldGet(this, _InversifyAdapter_instances, "m", _InversifyAdapter_isSingleton).call(this, typeSymbol.symbol)) {
+            return this.container.get(typeSymbol.symbol);
+        }
+        const result = this.container.get(typeSymbol.symbol);
+        this.loaded.add(typeSymbol.symbol);
+        return result;
+    }
+    /**
+     * Gets an instance of type T asynchronously.
+     * For singleton-scoped dependencies, also tracks that they have been loaded.
+     *
+     * @template T - The type of instance to get
+     * @param typeSymbol - The type symbol identifying the dependency
+     * @returns A promise that resolves to an instance of type T
+     * @throws Error if the dependency is not found
+     */
+    async get(typeSymbol) {
+        if (!__classPrivateFieldGet(this, _InversifyAdapter_instances, "m", _InversifyAdapter_isSingleton).call(this, typeSymbol.symbol)) {
+            return this.container.getAsync(typeSymbol.symbol);
+        }
+        const result = await this.container.getAsync(typeSymbol.symbol);
+        this.loaded.add(typeSymbol.symbol);
+        return result;
+    }
+    /**
+     * Binds a TypeWire to the InversifyJS container.
+     * Configures the binding with the appropriate scope and creator function.
+     *
+     * @param typeWire - The TypeWire to bind
+     */
+    bind(typeWire) {
+        const bound = this.container
+            .bind(typeWire.type.symbol)
+            .toDynamicValue((_ctx) => {
+            return typeWire.creator(this);
+        });
+        const scope = adoptScope(typeWire.scope);
+        if (scope) {
+            switch (scope) {
+                case "Singleton":
+                    this.singletons.add(typeWire.type.symbol);
+                    bound.inSingletonScope();
+                    break;
+                case "Transient":
+                    bound.inTransientScope();
+                    break;
+                case "Request":
+                    bound.inRequestScope();
+            }
+        }
+    }
+    /**
+     * Removes a binding from the InversifyJS container.
+     * Also removes any tracking information for the binding.
+     *
+     * @param typeSymbol - The type symbol identifying the binding to remove
+     * @returns A promise that resolves when the unbinding is complete
+     */
+    async unbind(typeSymbol) {
+        this.loaded.delete(typeSymbol.symbol);
+        this.singletons.delete(typeSymbol.symbol);
+        return this.container.unbind(typeSymbol.symbol);
+    }
+    /**
+     * Checks if a binding exists in the InversifyJS container.
+     *
+     * @param typeSymbol - The type symbol to check
+     * @returns True if the binding exists, false otherwise
+     */
+    isBound(typeSymbol) {
+        return this.container.isBound(typeSymbol.symbol);
+    }
+}
+exports.InversifyAdapter = InversifyAdapter;
+_InversifyAdapter_instances = new WeakSet(), _InversifyAdapter_isSingleton = function _InversifyAdapter_isSingleton(symbol) {
+    return this.singletons.has(symbol);
+};
+/**
+ * Creates an adapter that provides both TypeWire ResolutionContext and BindingContext
+ * interfaces using an InversifyJS container.
+ *
+ * This is a convenience function for creating an InversifyAdapter.
+ *
+ * @param container - The InversifyJS container to adapt
+ * @returns An object implementing both TypeWire interfaces
+ *
+ * @example
+ * ```typescript
+ * const container = new Container();
+ * const adapter = createInversifyAdapter(container);
+ *
+ * // Now you can use TypeWire with your InversifyJS container
+ * await serviceWire.apply(adapter);
+ * const service = await serviceWire.getInstance(adapter);
+ * ```
+ */
+function createInversifyAdapter(container) {
+    return new InversifyAdapter(container);
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,114 @@
+import type { AnyTypeSymbol, AnyTypeWire, BindingContext, TypeSymbol, ResolutionContext as TypeWireResolutionContext } from "@typewirets/core";
+import type { BindingScope, Container } from "inversify";
+/**
+ * Converts a TypeWire scope string to the equivalent InversifyJS BindingScope.
+ *
+ * @param scope - The TypeWire scope string (e.g., 'singleton', 'transient', 'request')
+ * @returns The equivalent InversifyJS BindingScope or undefined if no conversion is possible
+ *
+ * @example
+ * ```typescript
+ * // Convert a TypeWire scope to InversifyJS scope
+ * const inversifyScope = adoptScope('singleton'); // returns 'Singleton'
+ * ```
+ */
+export declare function adoptScope(scope?: string): BindingScope | undefined;
+/**
+ * Adapter class that provides both TypeWire ResolutionContext and BindingContext
+ * interfaces on top of an InversifyJS container.
+ *
+ * This adapter allows TypeWire definitions to work with an existing InversifyJS
+ * container, providing a bridge between the two dependency injection systems.
+ *
+ * @example
+ * ```typescript
+ * const container = new Container();
+ * const adapter = new InversifyAdapter(container);
+ *
+ * // Now you can use TypeWire with your InversifyJS container
+ * await serviceWire.apply(adapter);
+ * const service = await serviceWire.getInstance(adapter);
+ * ```
+ */
+export declare class InversifyAdapter implements TypeWireResolutionContext, BindingContext {
+    #private;
+    readonly container: Container;
+    /**
+     * Set of symbols for which instances have been loaded/initialized.
+     * Used to track which singleton instances have already been created.
+     */
+    private readonly loaded;
+    /**
+     * Set of symbols that represent singleton-scoped dependencies.
+     */
+    private readonly singletons;
+    /**
+     * Creates a new InversifyAdapter for the specified container.
+     *
+     * @param container - The InversifyJS container to adapt
+     */
+    constructor(container: Container);
+    /**
+     * Gets an instance of type T synchronously.
+     * For singleton-scoped dependencies, also tracks that they have been loaded.
+     *
+     * @template T - The type of instance to get
+     * @param typeSymbol - The type symbol identifying the dependency
+     * @returns An instance of type T
+     * @throws Error if the dependency cannot be resolved synchronously
+     */
+    getSync<T>(typeSymbol: AnyTypeSymbol): T;
+    /**
+     * Gets an instance of type T asynchronously.
+     * For singleton-scoped dependencies, also tracks that they have been loaded.
+     *
+     * @template T - The type of instance to get
+     * @param typeSymbol - The type symbol identifying the dependency
+     * @returns A promise that resolves to an instance of type T
+     * @throws Error if the dependency is not found
+     */
+    get<T>(typeSymbol: TypeSymbol<T>): Promise<T>;
+    /**
+     * Binds a TypeWire to the InversifyJS container.
+     * Configures the binding with the appropriate scope and creator function.
+     *
+     * @param typeWire - The TypeWire to bind
+     */
+    bind(typeWire: AnyTypeWire): void | Promise<void>;
+    /**
+     * Removes a binding from the InversifyJS container.
+     * Also removes any tracking information for the binding.
+     *
+     * @param typeSymbol - The type symbol identifying the binding to remove
+     * @returns A promise that resolves when the unbinding is complete
+     */
+    unbind(typeSymbol: AnyTypeSymbol): Promise<void>;
+    /**
+     * Checks if a binding exists in the InversifyJS container.
+     *
+     * @param typeSymbol - The type symbol to check
+     * @returns True if the binding exists, false otherwise
+     */
+    isBound(typeSymbol: AnyTypeSymbol): boolean;
+}
+/**
+ * Creates an adapter that provides both TypeWire ResolutionContext and BindingContext
+ * interfaces using an InversifyJS container.
+ *
+ * This is a convenience function for creating an InversifyAdapter.
+ *
+ * @param container - The InversifyJS container to adapt
+ * @returns An object implementing both TypeWire interfaces
+ *
+ * @example
+ * ```typescript
+ * const container = new Container();
+ * const adapter = createInversifyAdapter(container);
+ *
+ * // Now you can use TypeWire with your InversifyJS container
+ * await serviceWire.apply(adapter);
+ * const service = await serviceWire.getInstance(adapter);
+ * ```
+ */
+export declare function createInversifyAdapter(container: Container): TypeWireResolutionContext & BindingContext;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACV,iBAAiB,IAAI,yBAAyB,EAC/C,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAanE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBACX,YAAW,yBAAyB,EAAE,cAAc;;IAkBxC,QAAQ,CAAC,SAAS,EAAE,SAAS;IAhBzC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IAEjD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IAErD;;;;OAIG;gBACkB,SAAS,EAAE,SAAS;IAYzC;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,aAAa,GAAG,CAAC;IAUxC;;;;;;;;OAQG;IACG,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAUnD;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjD;;;;;;OAMG;IACG,MAAM,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtD;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO;CAG5C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,GACnB,yBAAyB,GAAG,cAAc,CAE5C"}