sandly 0.1.0 → 0.3.0

package/README.md

@@ -4,7 +4,7 @@
 
 A dependency injection framework for TypeScript that emphasizes complete type safety, modular architecture, and scope management.
 
-*Sandly* stands for **Services & Layers** - reflecting the framework's core concepts of organizing code into composable service layers.
+_Sandly_ stands for **Services & Layers** - reflecting the framework's core concepts of organizing code into composable service layers.
 
 ## Key Features
 
@@ -17,19 +17,19 @@ A dependency injection framework for TypeScript that emphasizes complete type sa
 ```typescript
 import { container, Tag } from 'sandly';
 
-class DatabaseService extends Tag.Class('DatabaseService') {
+class DatabaseService extends Tag.Service('DatabaseService') {
 	query() {
 		return ['data'];
 	}
 }
 
-const c = container().register(DatabaseService, () => new DatabaseService());
+const container = Container.empty().register(DatabaseService, () => new DatabaseService());
 
 // ✅ TypeScript knows DatabaseService is available
-const db = await c.get(DatabaseService);
+const db = await container.resolve(DatabaseService);
 
 // ❌ Compile error - UserService not registered
-const user = await c.get(UserService); // Type error
+const user = await container.resolve(UserService); // Type error
 ```
 
 ### Modular Architecture with Layers
@@ -47,7 +47,7 @@ const userServiceLayer = layer<typeof DatabaseService, typeof UserService>(
 	(container) =>
 		container.register(
 			UserService,
-			async (c) => new UserService(await c.get(DatabaseService))
+			async (c) => new UserService(await c.resolve(DatabaseService))
 		)
 );
 
@@ -73,11 +73,11 @@ export const handler = async (event, context) => {
 	// Create request scope for this invocation
 	const requestContainer = runtime.child('request').register(
 		UserService,
-		async (c) => new UserService(await c.get(DatabaseService)) // Uses runtime DB
+		async (c) => new UserService(await c.resolve(DatabaseService)) // Uses runtime DB
 	);
 
 	try {
-		const userService = await requestContainer.get(UserService);
+		const userService = await requestContainer.resolve(UserService);
 		return await userService.handleRequest(event);
 	} finally {
 		await requestContainer.destroy(); // Cleanup request scope
@@ -92,13 +92,13 @@ export const handler = async (event, context) => {
 ```typescript
 import { container, Tag } from 'sandly';
 
-class EmailService extends Tag.Class('EmailService') {
+class EmailService extends Tag.Service('EmailService') {
 	sendEmail(to: string, subject: string) {
 		return { messageId: 'msg-123' };
 	}
 }
 
-class UserService extends Tag.Class('UserService') {
+class UserService extends Tag.Service('UserService') {
 	constructor(private emailService: EmailService) {
 		super();
 	}
@@ -113,10 +113,10 @@ const app = container()
 	.register(EmailService, () => new EmailService())
 	.register(
 		UserService,
-		async (c) => new UserService(await c.get(EmailService))
+		async (c) => new UserService(await c.resolve(EmailService))
 	);
 
-const userService = await app.get(UserService);
+const userService = await app.resolve(UserService);
 ```
 
 ### Service Pattern with Auto-Composition
@@ -127,7 +127,7 @@ import { service, Layer } from 'sandly';
 const emailService = service(EmailService, () => new EmailService());
 const userService = service(
 	UserService,
-	async (container) => new UserService(await container.get(EmailService))
+	async (container) => new UserService(await container.resolve(EmailService))
 );
 
 // Automatic dependency resolution
@@ -140,7 +140,7 @@ const app = emailService().provide(userService()).register(container());
 const ApiKeyTag = Tag.of('apiKey')<string>();
 const ConfigTag = Tag.of('config')<{ dbUrl: string }>();
 
-class DatabaseService extends Tag.Class('DatabaseService') {
+class DatabaseService extends Tag.Service('DatabaseService') {
 	constructor(
 		private config: Inject<typeof ConfigTag>,
 		private apiKey: Inject<typeof ApiKeyTag>
@@ -155,7 +155,10 @@ const app = container()
 	.register(
 		DatabaseService,
 		async (c) =>
-			new DatabaseService(await c.get(ConfigTag), await c.get(ApiKeyTag))
+			new DatabaseService(
+				await c.resolve(ConfigTag),
+				await c.resolve(ApiKeyTag)
+			)
 	);
 ```
 
@@ -180,8 +183,8 @@ const userServiceLayer = layer<
 		UserService,
 		async (c) =>
 			new UserService(
-				await c.get(DatabaseService),
-				await c.get(CacheService)
+				await c.resolve(DatabaseService),
+				await c.resolve(CacheService)
 			)
 	)
 );