@izumisy-tailor/omakase-modules 0.2.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +0 -28
- package/docs/generated/README.md +35 -0
- package/docs/generated/_media/creating-modules.md +471 -0
- package/docs/{tutorials → generated/_media}/using-modules.md +69 -20
- package/docs/generated/builder/README.md +25 -0
- package/docs/generated/builder/functions/defineModule.md +60 -0
- package/docs/generated/builder/functions/withModuleConfiguration.md +68 -0
- package/docs/generated/builder/type-aliases/AnyDefinedModule.md +57 -0
- package/docs/generated/builder/type-aliases/ConfiguredDependencies.md +44 -0
- package/docs/generated/builder/type-aliases/ConfiguredModule.md +60 -0
- package/docs/generated/builder/type-aliases/DefinedModule.md +93 -0
- package/docs/generated/builder/type-aliases/DependencyModules.md +29 -0
- package/docs/generated/builder/type-aliases/EmptyDependencies.md +34 -0
- package/docs/generated/builder/type-aliases/ModuleBuilder.md +124 -0
- package/docs/generated/builder/type-aliases/ModuleBuilderProps.md +42 -0
- package/docs/generated/builder/type-aliases/ModuleFactoryContext.md +40 -0
- package/docs/generated/builder/type-aliases/TablesFromNames.md +28 -0
- package/docs/generated/config/README.md +19 -0
- package/docs/generated/config/classes/ModuleLoader.md +128 -0
- package/docs/generated/config/functions/loadModules.md +79 -0
- package/docs/generated/config/sdk/README.md +16 -0
- package/docs/generated/config/sdk/functions/getModulesReference.md +81 -0
- package/docs/generated/config/sdk/functions/loadModuleForDev.md +53 -0
- package/docs/generated/config/sdk/type-aliases/GetModulesReferenceOptions.md +60 -0
- package/docs/generated/config/type-aliases/LoadedModules.md +162 -0
- package/docs/generated/modules.md +11 -0
- package/package.json +17 -18
- package/src/builder/helpers.ts +388 -28
- package/src/builder/index.ts +8 -1
- package/src/builder/register.ts +38 -25
- package/src/config/module-loader.ts +251 -21
- package/src/config/sdk/dev-context.ts +82 -0
- package/src/config/sdk/index.ts +2 -1
- package/src/config/sdk/paths.ts +124 -13
- package/src/config/sdk/wrapper/base.ts +185 -0
- package/src/config/sdk/wrapper/generator.ts +89 -0
- package/src/config/sdk/wrapper/strategies.ts +121 -0
- package/docs/examples/data-models/core/inventory-module.md +0 -230
- package/docs/examples/data-models/core/order-module.md +0 -132
- package/docs/examples/data-models/scenarios/inventory-reservation-scenario.md +0 -73
- package/docs/examples/data-models/scenarios/multi-storefront-order-scenario.md +0 -99
- package/docs/examples/data-models/scenarios/order-payment-status-scenario.md +0 -92
- package/docs/examples/data-models/scenarios/procurement-order-scenario.md +0 -95
- package/docs/tutorials/creating-modules.md +0 -256
- package/src/config/module-registry.ts +0 -22
- package/src/stub-loader/index.ts +0 -3
- package/src/stub-loader/interface.ts +0 -40
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../modules.md) / builder
|
|
6
|
+
|
|
7
|
+
# builder
|
|
8
|
+
|
|
9
|
+
## Type Aliases
|
|
10
|
+
|
|
11
|
+
- [AnyDefinedModule](type-aliases/AnyDefinedModule.md)
|
|
12
|
+
- [ConfiguredDependencies](type-aliases/ConfiguredDependencies.md)
|
|
13
|
+
- [ConfiguredModule](type-aliases/ConfiguredModule.md)
|
|
14
|
+
- [DefinedModule](type-aliases/DefinedModule.md)
|
|
15
|
+
- [DependencyModules](type-aliases/DependencyModules.md)
|
|
16
|
+
- [EmptyDependencies](type-aliases/EmptyDependencies.md)
|
|
17
|
+
- [ModuleBuilder](type-aliases/ModuleBuilder.md)
|
|
18
|
+
- [ModuleBuilderProps](type-aliases/ModuleBuilderProps.md)
|
|
19
|
+
- [ModuleFactoryContext](type-aliases/ModuleFactoryContext.md)
|
|
20
|
+
- [TablesFromNames](type-aliases/TablesFromNames.md)
|
|
21
|
+
|
|
22
|
+
## Functions
|
|
23
|
+
|
|
24
|
+
- [defineModule](functions/defineModule.md)
|
|
25
|
+
- [withModuleConfiguration](functions/withModuleConfiguration.md)
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../../modules.md) / [builder](../README.md) / defineModule
|
|
6
|
+
|
|
7
|
+
# Function: defineModule()
|
|
8
|
+
|
|
9
|
+
> **defineModule**\<`C`, `Tables`\>(`baseProps`): [`ModuleBuilder`](../type-aliases/ModuleBuilder.md)\<`C`, `Tables`\>
|
|
10
|
+
|
|
11
|
+
Defined in: [builder/helpers.ts:341](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L341)
|
|
12
|
+
|
|
13
|
+
Defines a reusable module with optional dependencies on other modules.
|
|
14
|
+
|
|
15
|
+
## Type Parameters
|
|
16
|
+
|
|
17
|
+
| Type Parameter | Default type |
|
|
18
|
+
| ------ | ------ |
|
|
19
|
+
| `C` *extends* `Record`\<`string`, `unknown`\> | - |
|
|
20
|
+
| `Tables` *extends* `Record`\<`string`, `unknown`\> | `Record`\<`string`, `unknown`\> |
|
|
21
|
+
|
|
22
|
+
## Parameters
|
|
23
|
+
|
|
24
|
+
| Parameter | Type |
|
|
25
|
+
| ------ | ------ |
|
|
26
|
+
| `baseProps` | \{ `packageName`: `string`; \} |
|
|
27
|
+
| `baseProps.packageName` | `string` |
|
|
28
|
+
|
|
29
|
+
## Returns
|
|
30
|
+
|
|
31
|
+
[`ModuleBuilder`](../type-aliases/ModuleBuilder.md)\<`C`, `Tables`\>
|
|
32
|
+
|
|
33
|
+
## Example
|
|
34
|
+
|
|
35
|
+
```typescript
|
|
36
|
+
// Module without dependencies
|
|
37
|
+
export default defineModule<ModuleConfig, Tables>({
|
|
38
|
+
packageName: "my-module",
|
|
39
|
+
}).build();
|
|
40
|
+
|
|
41
|
+
// Module with dependencies - Deps type is automatically inferred
|
|
42
|
+
import commerceModule from "omakase-module-commerce-core";
|
|
43
|
+
import orderModule from "omakase-module-order";
|
|
44
|
+
|
|
45
|
+
export default defineModule<ModuleConfig, Tables>({
|
|
46
|
+
packageName: "my-module",
|
|
47
|
+
}).withDependencies({
|
|
48
|
+
commerce: commerceModule,
|
|
49
|
+
order: orderModule,
|
|
50
|
+
}).build();
|
|
51
|
+
|
|
52
|
+
// When configuring a module with dependencies, pass them as a record:
|
|
53
|
+
inventoryModule.configure({
|
|
54
|
+
config: { dbNamespace: "main-db" },
|
|
55
|
+
dependencies: {
|
|
56
|
+
commerce: $commerceModule,
|
|
57
|
+
order: $orderModule,
|
|
58
|
+
},
|
|
59
|
+
});
|
|
60
|
+
```
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../../modules.md) / [builder](../README.md) / withModuleConfiguration
|
|
6
|
+
|
|
7
|
+
# Function: withModuleConfiguration()
|
|
8
|
+
|
|
9
|
+
> **withModuleConfiguration**\<`C`, `Tables`, `Deps`, `Result`\>(`module`, `factory`): (`loadedModules`) => `Promise`\<`Result`\>
|
|
10
|
+
|
|
11
|
+
Defined in: [builder/register.ts:31](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/register.ts#L31)
|
|
12
|
+
|
|
13
|
+
Define module exports that depend on configuration from loadModules.
|
|
14
|
+
|
|
15
|
+
This function returns a factory function that takes LoadedModules as input
|
|
16
|
+
and produces the configured exports. The wrapper files generated by
|
|
17
|
+
getModulesReference will call this factory with the app's loadModules result.
|
|
18
|
+
|
|
19
|
+
## Type Parameters
|
|
20
|
+
|
|
21
|
+
| Type Parameter |
|
|
22
|
+
| ------ |
|
|
23
|
+
| `C` *extends* `Record`\<`string`, `unknown`\> |
|
|
24
|
+
| `Tables` *extends* `Record`\<`string`, `unknown`\> |
|
|
25
|
+
| `Deps` *extends* `Record`\<`string`, `any`\> |
|
|
26
|
+
| `Result` |
|
|
27
|
+
|
|
28
|
+
## Parameters
|
|
29
|
+
|
|
30
|
+
| Parameter | Type |
|
|
31
|
+
| ------ | ------ |
|
|
32
|
+
| `module` | [`DefinedModule`](../type-aliases/DefinedModule.md)\<`C`, `Tables`, `Deps`\> |
|
|
33
|
+
| `factory` | (`context`, `loadedModules`) => `Result` \| `Promise`\<`Result`\> |
|
|
34
|
+
|
|
35
|
+
## Returns
|
|
36
|
+
|
|
37
|
+
> (`loadedModules`): `Promise`\<`Result`\>
|
|
38
|
+
|
|
39
|
+
### Parameters
|
|
40
|
+
|
|
41
|
+
| Parameter | Type |
|
|
42
|
+
| ------ | ------ |
|
|
43
|
+
| `loadedModules` | [`LoadedModules`](../../config/type-aliases/LoadedModules.md) |
|
|
44
|
+
|
|
45
|
+
### Returns
|
|
46
|
+
|
|
47
|
+
`Promise`\<`Result`\>
|
|
48
|
+
|
|
49
|
+
## Example
|
|
50
|
+
|
|
51
|
+
```typescript
|
|
52
|
+
// In module's tailordb/index.ts
|
|
53
|
+
export default withModuleConfiguration(moduleDef, (context) => {
|
|
54
|
+
const inventory = buildInventoryTable(context);
|
|
55
|
+
return { inventory };
|
|
56
|
+
});
|
|
57
|
+
|
|
58
|
+
// In module's executors that need dependency module tables:
|
|
59
|
+
export default withModuleConfiguration(moduleDef, async (context, loadedModules) => {
|
|
60
|
+
const { productVariant } = await loadedModules.getTables(commerceModuleTables);
|
|
61
|
+
return createExecutor({ ... });
|
|
62
|
+
});
|
|
63
|
+
|
|
64
|
+
// The wrapper file will call it like:
|
|
65
|
+
// import factory from "module/backend/tailordb";
|
|
66
|
+
// import modules from "../../modules";
|
|
67
|
+
// export default await factory(modules);
|
|
68
|
+
```
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../../modules.md) / [builder](../README.md) / AnyDefinedModule
|
|
6
|
+
|
|
7
|
+
# Type Alias: AnyDefinedModule
|
|
8
|
+
|
|
9
|
+
> **AnyDefinedModule** = `object`
|
|
10
|
+
|
|
11
|
+
Defined in: [builder/helpers.ts:127](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L127)
|
|
12
|
+
|
|
13
|
+
A loosely-typed representation of any defined module.
|
|
14
|
+
|
|
15
|
+
This type is used in dependency records where the exact type parameters
|
|
16
|
+
of the module are not important. It provides the minimal interface needed
|
|
17
|
+
to work with modules as dependencies.
|
|
18
|
+
|
|
19
|
+
For strongly-typed module definitions, use [DefinedModule](DefinedModule.md) instead.
|
|
20
|
+
|
|
21
|
+
## See
|
|
22
|
+
|
|
23
|
+
[DefinedModule](DefinedModule.md) for the fully-typed module definition.
|
|
24
|
+
|
|
25
|
+
## Properties
|
|
26
|
+
|
|
27
|
+
### configure()
|
|
28
|
+
|
|
29
|
+
> **configure**: (`props`) => [`ConfiguredModule`](ConfiguredModule.md)\<`any`\>
|
|
30
|
+
|
|
31
|
+
Defined in: [builder/helpers.ts:130](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L130)
|
|
32
|
+
|
|
33
|
+
#### Parameters
|
|
34
|
+
|
|
35
|
+
| Parameter | Type |
|
|
36
|
+
| ------ | ------ |
|
|
37
|
+
| `props` | `any` |
|
|
38
|
+
|
|
39
|
+
#### Returns
|
|
40
|
+
|
|
41
|
+
[`ConfiguredModule`](ConfiguredModule.md)\<`any`\>
|
|
42
|
+
|
|
43
|
+
***
|
|
44
|
+
|
|
45
|
+
### dependencies
|
|
46
|
+
|
|
47
|
+
> **dependencies**: `Record`\<`string`, `any`\>
|
|
48
|
+
|
|
49
|
+
Defined in: [builder/helpers.ts:129](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L129)
|
|
50
|
+
|
|
51
|
+
***
|
|
52
|
+
|
|
53
|
+
### packageName
|
|
54
|
+
|
|
55
|
+
> **packageName**: `string`
|
|
56
|
+
|
|
57
|
+
Defined in: [builder/helpers.ts:128](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L128)
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../../modules.md) / [builder](../README.md) / ConfiguredDependencies
|
|
6
|
+
|
|
7
|
+
# Type Alias: ConfiguredDependencies\<Deps\>
|
|
8
|
+
|
|
9
|
+
> **ConfiguredDependencies**\<`Deps`\> = `{ [K in keyof Deps as K extends "__empty" ? never : K]: Deps[K] extends { __configBrand?: infer C } ? C extends Record<string, unknown> ? ConfiguredModule<C> : never : never }`
|
|
10
|
+
|
|
11
|
+
Defined in: [builder/helpers.ts:170](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L170)
|
|
12
|
+
|
|
13
|
+
Transforms a record of [DefinedModule](DefinedModule.md)s into a record of [ConfiguredModule](ConfiguredModule.md)s.
|
|
14
|
+
|
|
15
|
+
This utility type is used to derive the expected shape of the `dependencies`
|
|
16
|
+
property when configuring a module that has dependencies. It preserves
|
|
17
|
+
the exact configuration type for each dependency module.
|
|
18
|
+
|
|
19
|
+
## Type Parameters
|
|
20
|
+
|
|
21
|
+
| Type Parameter |
|
|
22
|
+
| ------ |
|
|
23
|
+
| `Deps` *extends* [`DependencyModules`](DependencyModules.md) |
|
|
24
|
+
|
|
25
|
+
## Example
|
|
26
|
+
|
|
27
|
+
```typescript
|
|
28
|
+
// When a module is defined with dependencies:
|
|
29
|
+
defineModule<MyConfig, MyTables>({
|
|
30
|
+
packageName: "my-module",
|
|
31
|
+
}).withDependencies({
|
|
32
|
+
commerce: commerceModule,
|
|
33
|
+
order: orderModule,
|
|
34
|
+
}).build();
|
|
35
|
+
|
|
36
|
+
// The configure() method will expect:
|
|
37
|
+
myModule.configure({
|
|
38
|
+
config: { ... },
|
|
39
|
+
dependencies: {
|
|
40
|
+
commerce: ConfiguredModule<CommerceConfig>,
|
|
41
|
+
order: ConfiguredModule<OrderConfig>,
|
|
42
|
+
},
|
|
43
|
+
});
|
|
44
|
+
```
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../../modules.md) / [builder](../README.md) / ConfiguredModule
|
|
6
|
+
|
|
7
|
+
# Type Alias: ConfiguredModule\<C\>
|
|
8
|
+
|
|
9
|
+
> **ConfiguredModule**\<`C`\> = `object`
|
|
10
|
+
|
|
11
|
+
Defined in: [builder/helpers.ts:80](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L80)
|
|
12
|
+
|
|
13
|
+
A module that has been configured with specific settings.
|
|
14
|
+
|
|
15
|
+
This type represents the result of calling `configure()` on a [DefinedModule](DefinedModule.md).
|
|
16
|
+
Configured modules can be passed as dependencies to other modules or used
|
|
17
|
+
directly in your application's Tailor configuration.
|
|
18
|
+
|
|
19
|
+
## Example
|
|
20
|
+
|
|
21
|
+
```typescript
|
|
22
|
+
// Create a configured module
|
|
23
|
+
const $commerceModule = commerceModule.configure({
|
|
24
|
+
config: { dbNamespace: "main-db" },
|
|
25
|
+
});
|
|
26
|
+
|
|
27
|
+
// Use as a dependency in another module
|
|
28
|
+
const $inventoryModule = inventoryModule.configure({
|
|
29
|
+
config: { dbNamespace: "main-db" },
|
|
30
|
+
dependencies: {
|
|
31
|
+
commerce: $commerceModule,
|
|
32
|
+
},
|
|
33
|
+
});
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Type Parameters
|
|
37
|
+
|
|
38
|
+
| Type Parameter | Default type |
|
|
39
|
+
| ------ | ------ |
|
|
40
|
+
| `C` *extends* `Record`\<`string`, `unknown`\> | `Record`\<`string`, `unknown`\> |
|
|
41
|
+
|
|
42
|
+
## Properties
|
|
43
|
+
|
|
44
|
+
### moduleProps
|
|
45
|
+
|
|
46
|
+
> **moduleProps**: `object`
|
|
47
|
+
|
|
48
|
+
Defined in: [builder/helpers.ts:87](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L87)
|
|
49
|
+
|
|
50
|
+
#### config
|
|
51
|
+
|
|
52
|
+
> **config**: `C`
|
|
53
|
+
|
|
54
|
+
***
|
|
55
|
+
|
|
56
|
+
### packageName
|
|
57
|
+
|
|
58
|
+
> **packageName**: `string`
|
|
59
|
+
|
|
60
|
+
Defined in: [builder/helpers.ts:86](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L86)
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../../modules.md) / [builder](../README.md) / DefinedModule
|
|
6
|
+
|
|
7
|
+
# Type Alias: DefinedModule\<C, Tables, Deps\>
|
|
8
|
+
|
|
9
|
+
> **DefinedModule**\<`C`, `Tables`, `Deps`\> = `object`
|
|
10
|
+
|
|
11
|
+
Defined in: [builder/helpers.ts:214](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L214)
|
|
12
|
+
|
|
13
|
+
A fully defined, reusable module that can be configured and composed.
|
|
14
|
+
|
|
15
|
+
This is the primary type for modules created with [defineModule](../functions/defineModule.md).
|
|
16
|
+
A `DefinedModule` encapsulates:
|
|
17
|
+
- The module's package name for identification
|
|
18
|
+
- Its dependencies on other modules
|
|
19
|
+
- A `configure()` method to create a [ConfiguredModule](ConfiguredModule.md)
|
|
20
|
+
- Optional development configuration for local testing
|
|
21
|
+
|
|
22
|
+
## Example
|
|
23
|
+
|
|
24
|
+
```typescript
|
|
25
|
+
// Define a module
|
|
26
|
+
const inventoryModule = defineModule<InventoryConfig, InventoryTables>({
|
|
27
|
+
packageName: "inventory-module",
|
|
28
|
+
})
|
|
29
|
+
.withDependencies({ commerce: commerceModule })
|
|
30
|
+
.withDevConfig({ dbNamespace: "dev" })
|
|
31
|
+
.build();
|
|
32
|
+
|
|
33
|
+
// Configure the module for use
|
|
34
|
+
const $inventory = inventoryModule.configure({
|
|
35
|
+
config: { dbNamespace: "production" },
|
|
36
|
+
dependencies: {
|
|
37
|
+
commerce: $commerceModule,
|
|
38
|
+
},
|
|
39
|
+
});
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Type Parameters
|
|
43
|
+
|
|
44
|
+
| Type Parameter | Default type |
|
|
45
|
+
| ------ | ------ |
|
|
46
|
+
| `C` *extends* `Record`\<`string`, `unknown`\> | - |
|
|
47
|
+
| `Tables` *extends* `Record`\<`string`, `unknown`\> | `Record`\<`string`, `unknown`\> |
|
|
48
|
+
| `Deps` *extends* [`DependencyModules`](DependencyModules.md) | [`EmptyDependencies`](EmptyDependencies.md) |
|
|
49
|
+
|
|
50
|
+
## Properties
|
|
51
|
+
|
|
52
|
+
### configure()
|
|
53
|
+
|
|
54
|
+
> **configure**: (`props`) => [`ConfiguredModule`](ConfiguredModule.md)\<`C`\>
|
|
55
|
+
|
|
56
|
+
Defined in: [builder/helpers.ts:230](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L230)
|
|
57
|
+
|
|
58
|
+
#### Parameters
|
|
59
|
+
|
|
60
|
+
| Parameter | Type |
|
|
61
|
+
| ------ | ------ |
|
|
62
|
+
| `props` | [`ModuleBuilderProps`](ModuleBuilderProps.md)\<`C`, `Deps`\> |
|
|
63
|
+
|
|
64
|
+
#### Returns
|
|
65
|
+
|
|
66
|
+
[`ConfiguredModule`](ConfiguredModule.md)\<`C`\>
|
|
67
|
+
|
|
68
|
+
***
|
|
69
|
+
|
|
70
|
+
### dependencies
|
|
71
|
+
|
|
72
|
+
> **dependencies**: `Deps`
|
|
73
|
+
|
|
74
|
+
Defined in: [builder/helpers.ts:229](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L229)
|
|
75
|
+
|
|
76
|
+
***
|
|
77
|
+
|
|
78
|
+
### devConfig?
|
|
79
|
+
|
|
80
|
+
> `optional` **devConfig**: `C`
|
|
81
|
+
|
|
82
|
+
Defined in: [builder/helpers.ts:235](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L235)
|
|
83
|
+
|
|
84
|
+
Default configuration for module development.
|
|
85
|
+
Used by loadModuleForDev when no config is provided.
|
|
86
|
+
|
|
87
|
+
***
|
|
88
|
+
|
|
89
|
+
### packageName
|
|
90
|
+
|
|
91
|
+
> **packageName**: `string`
|
|
92
|
+
|
|
93
|
+
Defined in: [builder/helpers.ts:228](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L228)
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../../modules.md) / [builder](../README.md) / DependencyModules
|
|
6
|
+
|
|
7
|
+
# Type Alias: DependencyModules
|
|
8
|
+
|
|
9
|
+
> **DependencyModules** = `Record`\<`string`, [`AnyDefinedModule`](AnyDefinedModule.md)\> \| [`EmptyDependencies`](EmptyDependencies.md)
|
|
10
|
+
|
|
11
|
+
Defined in: [builder/helpers.ts:112](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L112)
|
|
12
|
+
|
|
13
|
+
A record of module dependencies or an empty dependency set.
|
|
14
|
+
|
|
15
|
+
This type represents the dependencies that a module can declare.
|
|
16
|
+
It is either a record mapping dependency names to [AnyDefinedModule](AnyDefinedModule.md),
|
|
17
|
+
or [EmptyDependencies](EmptyDependencies.md) for modules without dependencies.
|
|
18
|
+
|
|
19
|
+
## Example
|
|
20
|
+
|
|
21
|
+
```typescript
|
|
22
|
+
// Used internally when defining module dependencies
|
|
23
|
+
defineModule<MyConfig, MyTables>({
|
|
24
|
+
packageName: "my-module",
|
|
25
|
+
}).withDependencies({
|
|
26
|
+
commerce: commerceModule, // Record<string, AnyDefinedModule>
|
|
27
|
+
order: orderModule,
|
|
28
|
+
}).build();
|
|
29
|
+
```
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../../modules.md) / [builder](../README.md) / EmptyDependencies
|
|
6
|
+
|
|
7
|
+
# Type Alias: EmptyDependencies
|
|
8
|
+
|
|
9
|
+
> **EmptyDependencies** = `object`
|
|
10
|
+
|
|
11
|
+
Defined in: [builder/helpers.ts:18](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L18)
|
|
12
|
+
|
|
13
|
+
Represents a module with no dependencies.
|
|
14
|
+
|
|
15
|
+
This is a branded type used internally to distinguish modules
|
|
16
|
+
that have no dependencies from those that do. When defining a module
|
|
17
|
+
without dependencies, you don't need to use this type directly.
|
|
18
|
+
|
|
19
|
+
## Example
|
|
20
|
+
|
|
21
|
+
```typescript
|
|
22
|
+
// Modules without dependencies don't need to specify this type
|
|
23
|
+
export default defineModule<MyConfig, MyTables>({
|
|
24
|
+
packageName: "my-module",
|
|
25
|
+
}).build();
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Properties
|
|
29
|
+
|
|
30
|
+
### \_\_empty?
|
|
31
|
+
|
|
32
|
+
> `readonly` `optional` **\_\_empty**: `never`
|
|
33
|
+
|
|
34
|
+
Defined in: [builder/helpers.ts:18](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L18)
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../../modules.md) / [builder](../README.md) / ModuleBuilder
|
|
6
|
+
|
|
7
|
+
# Type Alias: ModuleBuilder\<C, Tables, Deps\>
|
|
8
|
+
|
|
9
|
+
> **ModuleBuilder**\<`C`, `Tables`, `Deps`\> = `object`
|
|
10
|
+
|
|
11
|
+
Defined in: [builder/helpers.ts:251](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L251)
|
|
12
|
+
|
|
13
|
+
Intermediate builder type returned by defineModule.
|
|
14
|
+
Use .withDependencies() to add dependencies, then call .build() to finalize.
|
|
15
|
+
Modules without dependencies can call .build() directly.
|
|
16
|
+
|
|
17
|
+
## Type Parameters
|
|
18
|
+
|
|
19
|
+
| Type Parameter | Default type |
|
|
20
|
+
| ------ | ------ |
|
|
21
|
+
| `C` *extends* `Record`\<`string`, `unknown`\> | - |
|
|
22
|
+
| `Tables` *extends* `Record`\<`string`, `unknown`\> | - |
|
|
23
|
+
| `Deps` *extends* [`DependencyModules`](DependencyModules.md) | [`EmptyDependencies`](EmptyDependencies.md) |
|
|
24
|
+
|
|
25
|
+
## Properties
|
|
26
|
+
|
|
27
|
+
### build()
|
|
28
|
+
|
|
29
|
+
> **build**: () => [`DefinedModule`](DefinedModule.md)\<`C`, `Tables`, `Deps`\>
|
|
30
|
+
|
|
31
|
+
Defined in: [builder/helpers.ts:307](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L307)
|
|
32
|
+
|
|
33
|
+
Finalizes the module definition and returns the DefinedModule.
|
|
34
|
+
This must be called at the end of the builder chain to get the actual module.
|
|
35
|
+
|
|
36
|
+
#### Returns
|
|
37
|
+
|
|
38
|
+
[`DefinedModule`](DefinedModule.md)\<`C`, `Tables`, `Deps`\>
|
|
39
|
+
|
|
40
|
+
#### Example
|
|
41
|
+
|
|
42
|
+
```typescript
|
|
43
|
+
// Without dependencies
|
|
44
|
+
export default defineModule<ModuleConfig, Tables>({
|
|
45
|
+
packageName: "my-module",
|
|
46
|
+
}).build();
|
|
47
|
+
|
|
48
|
+
// With dependencies and dev config
|
|
49
|
+
export default defineModule<ModuleConfig, Tables>({
|
|
50
|
+
packageName: "my-module",
|
|
51
|
+
})
|
|
52
|
+
.withDependencies({ commerce: commerceModule })
|
|
53
|
+
.withDevConfig({ dbNamespace: "dev" })
|
|
54
|
+
.build();
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
***
|
|
58
|
+
|
|
59
|
+
### withDependencies()
|
|
60
|
+
|
|
61
|
+
> **withDependencies**: \<`NewDeps`\>(`deps`) => `ModuleBuilder`\<`C`, `Tables`, `NewDeps`\>
|
|
62
|
+
|
|
63
|
+
Defined in: [builder/helpers.ts:270](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L270)
|
|
64
|
+
|
|
65
|
+
Adds dependencies to the module definition.
|
|
66
|
+
The Deps type is automatically inferred from the record.
|
|
67
|
+
|
|
68
|
+
#### Type Parameters
|
|
69
|
+
|
|
70
|
+
| Type Parameter |
|
|
71
|
+
| ------ |
|
|
72
|
+
| `NewDeps` *extends* [`DependencyModules`](DependencyModules.md) |
|
|
73
|
+
|
|
74
|
+
#### Parameters
|
|
75
|
+
|
|
76
|
+
| Parameter | Type |
|
|
77
|
+
| ------ | ------ |
|
|
78
|
+
| `deps` | `NewDeps` |
|
|
79
|
+
|
|
80
|
+
#### Returns
|
|
81
|
+
|
|
82
|
+
`ModuleBuilder`\<`C`, `Tables`, `NewDeps`\>
|
|
83
|
+
|
|
84
|
+
#### Example
|
|
85
|
+
|
|
86
|
+
```typescript
|
|
87
|
+
export default defineModule<ModuleConfig, Tables>({
|
|
88
|
+
packageName: "my-module",
|
|
89
|
+
}).withDependencies({
|
|
90
|
+
commerce: commerceModule,
|
|
91
|
+
order: orderModule,
|
|
92
|
+
}).build();
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
***
|
|
96
|
+
|
|
97
|
+
### withDevConfig()
|
|
98
|
+
|
|
99
|
+
> **withDevConfig**: (`config`) => `ModuleBuilder`\<`C`, `Tables`, `Deps`\>
|
|
100
|
+
|
|
101
|
+
Defined in: [builder/helpers.ts:286](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L286)
|
|
102
|
+
|
|
103
|
+
Sets the default configuration for module development.
|
|
104
|
+
This config is used by loadModuleForDev when no config is provided.
|
|
105
|
+
|
|
106
|
+
#### Parameters
|
|
107
|
+
|
|
108
|
+
| Parameter | Type |
|
|
109
|
+
| ------ | ------ |
|
|
110
|
+
| `config` | `C` |
|
|
111
|
+
|
|
112
|
+
#### Returns
|
|
113
|
+
|
|
114
|
+
`ModuleBuilder`\<`C`, `Tables`, `Deps`\>
|
|
115
|
+
|
|
116
|
+
#### Example
|
|
117
|
+
|
|
118
|
+
```typescript
|
|
119
|
+
export default defineModule<ModuleConfig, Tables>({
|
|
120
|
+
packageName: "my-module",
|
|
121
|
+
}).withDevConfig({
|
|
122
|
+
dbNamespace: "main-db",
|
|
123
|
+
}).build();
|
|
124
|
+
```
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../../modules.md) / [builder](../README.md) / ModuleBuilderProps
|
|
6
|
+
|
|
7
|
+
# Type Alias: ModuleBuilderProps\<C, Deps\>
|
|
8
|
+
|
|
9
|
+
> **ModuleBuilderProps**\<`C`, `Deps`\> = `Deps` *extends* [`EmptyDependencies`](EmptyDependencies.md) ? `object` : `object`
|
|
10
|
+
|
|
11
|
+
Defined in: [builder/helpers.ts:44](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L44)
|
|
12
|
+
|
|
13
|
+
Properties required when configuring a module via `configure()`.
|
|
14
|
+
|
|
15
|
+
The shape of this type varies based on whether the module has dependencies:
|
|
16
|
+
- **Without dependencies**: `{ config: C }`
|
|
17
|
+
- **With dependencies**: `{ config: C; dependencies: ConfiguredDependencies<Deps> }`
|
|
18
|
+
|
|
19
|
+
## Type Parameters
|
|
20
|
+
|
|
21
|
+
| Type Parameter |
|
|
22
|
+
| ------ |
|
|
23
|
+
| `C` *extends* `Record`\<`string`, `unknown`\> |
|
|
24
|
+
| `Deps` *extends* [`DependencyModules`](DependencyModules.md) |
|
|
25
|
+
|
|
26
|
+
## Example
|
|
27
|
+
|
|
28
|
+
```typescript
|
|
29
|
+
// Module without dependencies
|
|
30
|
+
myModule.configure({
|
|
31
|
+
config: { dbNamespace: "main-db" },
|
|
32
|
+
});
|
|
33
|
+
|
|
34
|
+
// Module with dependencies
|
|
35
|
+
inventoryModule.configure({
|
|
36
|
+
config: { dbNamespace: "main-db" },
|
|
37
|
+
dependencies: {
|
|
38
|
+
commerce: $commerceModule,
|
|
39
|
+
order: $orderModule,
|
|
40
|
+
},
|
|
41
|
+
});
|
|
42
|
+
```
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
[**@izumisy-tailor/omakase-modules**](../../README.md)
|
|
2
|
+
|
|
3
|
+
***
|
|
4
|
+
|
|
5
|
+
[@izumisy-tailor/omakase-modules](../../modules.md) / [builder](../README.md) / ModuleFactoryContext
|
|
6
|
+
|
|
7
|
+
# Type Alias: ModuleFactoryContext\<C\>
|
|
8
|
+
|
|
9
|
+
> **ModuleFactoryContext**\<`C`\> = `object`
|
|
10
|
+
|
|
11
|
+
Defined in: [builder/helpers.ts:409](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L409)
|
|
12
|
+
|
|
13
|
+
Context passed to table builder functions.
|
|
14
|
+
Provides access to the module's configuration.
|
|
15
|
+
|
|
16
|
+
## Example
|
|
17
|
+
|
|
18
|
+
```typescript
|
|
19
|
+
export const buildProductTable = (
|
|
20
|
+
{ config }: ModuleFactoryContext<ModuleConfig>,
|
|
21
|
+
deps: { category: TailorDBType }
|
|
22
|
+
) => {
|
|
23
|
+
const prefix = config.dataModel?.product?.docNumberPrefix ?? "PROD";
|
|
24
|
+
return db.type("Product", { ... });
|
|
25
|
+
};
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Type Parameters
|
|
29
|
+
|
|
30
|
+
| Type Parameter |
|
|
31
|
+
| ------ |
|
|
32
|
+
| `C` *extends* `Record`\<`string`, `unknown`\> |
|
|
33
|
+
|
|
34
|
+
## Properties
|
|
35
|
+
|
|
36
|
+
### config
|
|
37
|
+
|
|
38
|
+
> **config**: `C`
|
|
39
|
+
|
|
40
|
+
Defined in: [builder/helpers.ts:410](https://github.com/tailor-sandbox/omakase-modules/blob/c8d6563533665d8bb159b4602b5c906b40e938f2/packages/core/src/builder/helpers.ts#L410)
|