@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.
Files changed (47) hide show
  1. package/README.md +0 -28
  2. package/docs/generated/README.md +35 -0
  3. package/docs/generated/_media/creating-modules.md +471 -0
  4. package/docs/{tutorials → generated/_media}/using-modules.md +69 -20
  5. package/docs/generated/builder/README.md +25 -0
  6. package/docs/generated/builder/functions/defineModule.md +60 -0
  7. package/docs/generated/builder/functions/withModuleConfiguration.md +68 -0
  8. package/docs/generated/builder/type-aliases/AnyDefinedModule.md +57 -0
  9. package/docs/generated/builder/type-aliases/ConfiguredDependencies.md +44 -0
  10. package/docs/generated/builder/type-aliases/ConfiguredModule.md +60 -0
  11. package/docs/generated/builder/type-aliases/DefinedModule.md +93 -0
  12. package/docs/generated/builder/type-aliases/DependencyModules.md +29 -0
  13. package/docs/generated/builder/type-aliases/EmptyDependencies.md +34 -0
  14. package/docs/generated/builder/type-aliases/ModuleBuilder.md +124 -0
  15. package/docs/generated/builder/type-aliases/ModuleBuilderProps.md +42 -0
  16. package/docs/generated/builder/type-aliases/ModuleFactoryContext.md +40 -0
  17. package/docs/generated/builder/type-aliases/TablesFromNames.md +28 -0
  18. package/docs/generated/config/README.md +19 -0
  19. package/docs/generated/config/classes/ModuleLoader.md +128 -0
  20. package/docs/generated/config/functions/loadModules.md +79 -0
  21. package/docs/generated/config/sdk/README.md +16 -0
  22. package/docs/generated/config/sdk/functions/getModulesReference.md +81 -0
  23. package/docs/generated/config/sdk/functions/loadModuleForDev.md +53 -0
  24. package/docs/generated/config/sdk/type-aliases/GetModulesReferenceOptions.md +60 -0
  25. package/docs/generated/config/type-aliases/LoadedModules.md +162 -0
  26. package/docs/generated/modules.md +11 -0
  27. package/package.json +17 -18
  28. package/src/builder/helpers.ts +388 -28
  29. package/src/builder/index.ts +8 -1
  30. package/src/builder/register.ts +38 -25
  31. package/src/config/module-loader.ts +251 -21
  32. package/src/config/sdk/dev-context.ts +82 -0
  33. package/src/config/sdk/index.ts +2 -1
  34. package/src/config/sdk/paths.ts +124 -13
  35. package/src/config/sdk/wrapper/base.ts +185 -0
  36. package/src/config/sdk/wrapper/generator.ts +89 -0
  37. package/src/config/sdk/wrapper/strategies.ts +121 -0
  38. package/docs/examples/data-models/core/inventory-module.md +0 -230
  39. package/docs/examples/data-models/core/order-module.md +0 -132
  40. package/docs/examples/data-models/scenarios/inventory-reservation-scenario.md +0 -73
  41. package/docs/examples/data-models/scenarios/multi-storefront-order-scenario.md +0 -99
  42. package/docs/examples/data-models/scenarios/order-payment-status-scenario.md +0 -92
  43. package/docs/examples/data-models/scenarios/procurement-order-scenario.md +0 -95
  44. package/docs/tutorials/creating-modules.md +0 -256
  45. package/src/config/module-registry.ts +0 -22
  46. package/src/stub-loader/index.ts +0 -3
  47. 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)