@mantajs/core 0.2.0-beta.7 → 0.2.0-beta.9
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/dist/query/define-query.d.ts +17 -1
- package/dist/query/define-query.d.ts.map +1 -1
- package/dist/query/define-query.js.map +1 -1
- package/dist/query/index.d.ts.map +1 -1
- package/dist/query/index.js +7 -1
- package/dist/query/index.js.map +1 -1
- package/dist/service/define.d.ts +9 -1
- package/dist/service/define.d.ts.map +1 -1
- package/dist/service/define.js.map +1 -1
- package/dist/service/instantiate.d.ts +7 -1
- package/dist/service/instantiate.d.ts.map +1 -1
- package/dist/service/instantiate.js +9 -2
- package/dist/service/instantiate.js.map +1 -1
- package/docs/03-services.md +23 -5
- package/docs/06-queries.md +54 -23
- package/docs/15-hosts.md +2 -0
- package/package.json +1 -1
|
@@ -1,13 +1,29 @@
|
|
|
1
1
|
import type { z } from 'zod';
|
|
2
2
|
import type { AuthContext } from '../auth/types.js';
|
|
3
|
+
import type { IDatabasePort } from '../ports/database.js';
|
|
3
4
|
import type { ILoggerPort } from '../ports/logger.js';
|
|
4
5
|
import type { QueryService } from './index.js';
|
|
5
6
|
/**
|
|
6
7
|
* Query handler context — what the developer receives in the handler.
|
|
7
8
|
*/
|
|
8
9
|
export interface QueryHandlerContext {
|
|
9
|
-
/**
|
|
10
|
+
/**
|
|
11
|
+
* QueryService for generated admin reads and legacy graph queries.
|
|
12
|
+
*
|
|
13
|
+
* Application code should prefer `drizzle` + `schema` for new reads. The graph
|
|
14
|
+
* API remains available for generated surfaces that need dynamic entity access.
|
|
15
|
+
*/
|
|
10
16
|
query: QueryService;
|
|
17
|
+
/** The configured database adapter, including raw SQL and pool access. */
|
|
18
|
+
database: IDatabasePort;
|
|
19
|
+
/** The schema-aware Drizzle client for first-class application reads. */
|
|
20
|
+
drizzle: unknown;
|
|
21
|
+
/** Backwards-compatible alias for `drizzle`. */
|
|
22
|
+
db: unknown;
|
|
23
|
+
/** Generated Drizzle tables keyed by table/entity names. */
|
|
24
|
+
schema: Record<string, unknown>;
|
|
25
|
+
/** Drizzle tagged SQL helper for advanced expressions. */
|
|
26
|
+
sql: typeof import('drizzle-orm').sql;
|
|
11
27
|
/** Structured logger. */
|
|
12
28
|
log: ILoggerPort;
|
|
13
29
|
/** Authenticated user context (null if public route). */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-query.d.ts","sourceRoot":"","sources":["../../src/query/define-query.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC
|
|
1
|
+
{"version":3,"file":"define-query.d.ts","sourceRoot":"","sources":["../../src/query/define-query.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,KAAK,EAAE,YAAY,CAAA;IACnB,0EAA0E;IAC1E,QAAQ,EAAE,aAAa,CAAA;IACvB,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAA;IAChB,gDAAgD;IAChD,EAAE,EAAE,OAAO,CAAA;IACX,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,0DAA0D;IAC1D,GAAG,EAAE,cAAc,aAAa,EAAE,GAAG,CAAA;IACrC,yBAAyB;IACzB,GAAG,EAAE,WAAW,CAAA;IAChB,yDAAyD;IACzD,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;IACxB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC3E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAClE,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1E,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BnH;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAqC;IAErD,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAOpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI9C,IAAI,IAAI,eAAe,EAAE;IAIzB,MAAM,IAAI,IAAI;CAGf"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-query.js","sourceRoot":"","sources":["../../src/query/define-query.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,iEAAiE;AAIjE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;
|
|
1
|
+
{"version":3,"file":"define-query.js","sourceRoot":"","sources":["../../src/query/define-query.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,iEAAiE;AAIjE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAuDrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,WAAW,CAAkB,MAAoC;IAC/E,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,UAAU,CAClB,cAAc,EACd,+JAA+J,CAChK,CAAA;IACH,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,UAAU,MAAM,CAAC,IAAI,2BAA2B,CAAC,CAAA;IACxF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,UAAU,CAClB,cAAc,EACd,UAAU,MAAM,CAAC,IAAI,kFAAkF,CACxG,CAAA;IACH,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,UAAU,CAClB,cAAc,EACd,UAAU,MAAM,CAAC,IAAI,iFAAiF,CACvG,CAAA;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,OAAO;KAChB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAA;IAErD,QAAQ,CAAC,GAAoB;QAC3B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,UAAU,GAAG,CAAC,IAAI,yBAAyB,CAAC,CAAA;QACtF,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAClC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IACpC,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC;CACF"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"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"}
|
package/dist/query/index.js
CHANGED
|
@@ -147,6 +147,9 @@ export class QueryService {
|
|
|
147
147
|
// Always delegate when we have one — it handles alias resolution for relation fields
|
|
148
148
|
// (e.g. 'customers' → M:N relation via pivot table)
|
|
149
149
|
if (this._relationalQuery) {
|
|
150
|
+
if (config.q?.trim()) {
|
|
151
|
+
throw new MantaError('INVALID_DATA', 'query.graph({ q }) is not supported on the relational path because it would filter rows in application memory. Use a defineQuery() handler with Drizzle ilike/full-text SQL instead.');
|
|
152
|
+
}
|
|
150
153
|
const results = await this._relationalQuery.findWithRelations({
|
|
151
154
|
entity: config.entity,
|
|
152
155
|
fields: config.fields,
|
|
@@ -160,7 +163,7 @@ export class QueryService {
|
|
|
160
163
|
if (!config.dangerouslyUnboundedRelations && results.length > this._maxTotalEntities) {
|
|
161
164
|
throw new MantaError('INVALID_DATA', `Query returned ${results.length} entities, exceeding maximum of ${this._maxTotalEntities}. Use pagination or reduce scope.`);
|
|
162
165
|
}
|
|
163
|
-
return
|
|
166
|
+
return results;
|
|
164
167
|
}
|
|
165
168
|
// Fallback to legacy resolver path
|
|
166
169
|
const resolver = this._resolvers.get(entityKey);
|
|
@@ -236,6 +239,9 @@ export class QueryService {
|
|
|
236
239
|
return [rows, rows.length];
|
|
237
240
|
}
|
|
238
241
|
if (this._relationalQuery) {
|
|
242
|
+
if (config.q?.trim()) {
|
|
243
|
+
throw new MantaError('INVALID_DATA', 'query.graphAndCount({ q }) is not supported on the relational path because it would filter rows in application memory. Use a defineQuery() handler with Drizzle ilike/full-text SQL instead.');
|
|
244
|
+
}
|
|
239
245
|
const [results, count] = await this._relationalQuery.findAndCountWithRelations({
|
|
240
246
|
entity: config.entity,
|
|
241
247
|
fields: config.fields,
|
package/dist/query/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"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"}
|
package/dist/service/define.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { DmlEntity } from '../dml/entity.js';
|
|
2
2
|
import type { InferEntity } from '../dml/infer.js';
|
|
3
3
|
import type { ModelProxy, ModelRef } from '../link/index.js';
|
|
4
|
+
import type { IDatabasePort } from '../ports/database.js';
|
|
4
5
|
import type { ILoggerPort } from '../ports/logger.js';
|
|
5
6
|
import type { CursorPagination } from '../ports/types.js';
|
|
6
7
|
/**
|
|
@@ -39,11 +40,18 @@ export interface TypedRepository<T> {
|
|
|
39
40
|
type ServiceMethods = Record<string, (...args: any[]) => Promise<any>>;
|
|
40
41
|
/**
|
|
41
42
|
* Context passed to the service factory.
|
|
42
|
-
* - `db` — typed repository for CRUD operations
|
|
43
|
+
* - `db` — typed repository for generated CRUD operations
|
|
44
|
+
* - `drizzle` — schema-aware Drizzle client for first-class mutations
|
|
45
|
+
* - `schema` — generated Drizzle tables keyed by table/entity names
|
|
46
|
+
* - `database` — configured database adapter for raw SQL / pool access
|
|
43
47
|
* - `log` — logger instance
|
|
44
48
|
*/
|
|
45
49
|
export interface ServiceFactoryContext<T> {
|
|
46
50
|
db: TypedRepository<T>;
|
|
51
|
+
drizzle: unknown;
|
|
52
|
+
schema: Record<string, unknown>;
|
|
53
|
+
database: IDatabasePort;
|
|
54
|
+
sql: typeof import('drizzle-orm').sql;
|
|
47
55
|
log: ILoggerPort;
|
|
48
56
|
}
|
|
49
57
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/service/define.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAClB,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAA;QACzD,MAAM,CAAC,EAAE,gBAAgB,CAAA;KAC1B,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;IAChB,YAAY,CAAC,OAAO,CAAC,EAAE;QACrB,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAClB,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAA;KAC1D,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAA;IAC1B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACzD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACrD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IACrE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;CACzG;AAED;;;GAGG;AAEH,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;AAEtE
|
|
1
|
+
{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/service/define.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/service/define.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,sEAAsE;AACtE,8EAA8E;AAC9E,0DAA0D;AAC1D,EAAE;AACF,SAAS;AACT,gEAAgE;AAChE,uCAAuC;AACvC,qDAAqD;AACrD,4CAA4C;AAC5C,SAAS;AACT,QAAQ;AAKR,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;
|
|
1
|
+
{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/service/define.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,sEAAsE;AACtE,8EAA8E;AAC9E,0DAA0D;AAC1D,EAAE;AACF,SAAS;AACT,gEAAgE;AAChE,uCAAuC;AACvC,qDAAqD;AACrD,4CAA4C;AAC5C,SAAS;AACT,QAAQ;AAKR,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAyEnD;;GAEG;AACH,yDAAyD;AACzD,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAAiC,CAAC,MAAM,KAAK,SAAS,CAAA;AAC/G,CAAC;AAwCD,uEAAuE;AACvE,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAC3B,gBAAmE,EACnE,OAAqD,EACrD,OAAwD;IAExD,IAAI,UAAkB,CAAA;IAEtB,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QACzC,UAAU,GAAG,gBAAgB,CAAA;IAC/B,CAAC;SAAM,CAAC;QACN,uBAAuB;QACvB,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAA;QAChC,MAAM,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QACnC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAA;IAC7B,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAkB;QAC1B,+FAA+F;QAC/F,MAAM,EAAE,IAAiC;QACzC,OAAO;QACP,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,OAAO,EAAE,aAAa;QACrC,WAAW,EAAE,UAAU;KACxB,CAAA;AACH,CAAC"}
|
|
@@ -2,6 +2,12 @@ import type { IMessageAggregator } from '../events/types.js';
|
|
|
2
2
|
import type { ILoggerPort } from '../ports/logger.js';
|
|
3
3
|
import type { IRepository } from '../ports/repository.js';
|
|
4
4
|
import type { ServiceDescriptor } from './define.js';
|
|
5
|
+
export interface ServiceRuntimeDataContext {
|
|
6
|
+
database?: import('../ports/database.js').IDatabasePort;
|
|
7
|
+
drizzle?: unknown;
|
|
8
|
+
schema?: Record<string, unknown>;
|
|
9
|
+
sql?: typeof import('drizzle-orm').sql;
|
|
10
|
+
}
|
|
5
11
|
/**
|
|
6
12
|
* Instantiate a ServiceDescriptor into a live service object.
|
|
7
13
|
*
|
|
@@ -11,5 +17,5 @@ import type { ServiceDescriptor } from './define.js';
|
|
|
11
17
|
* @param logger - Optional logger instance for the service factory context
|
|
12
18
|
* @returns The fully-wired service object with CRUD + query helpers + custom methods
|
|
13
19
|
*/
|
|
14
|
-
export declare function instantiateServiceDescriptor(descriptor: ServiceDescriptor<any, any>, repo: IRepository, messageAggregator?: IMessageAggregator, logger?: ILoggerPort): Record<string, unknown>;
|
|
20
|
+
export declare function instantiateServiceDescriptor(descriptor: ServiceDescriptor<any, any>, repo: IRepository, messageAggregator?: IMessageAggregator, logger?: ILoggerPort, runtimeData?: ServiceRuntimeDataContext): Record<string, unknown>;
|
|
15
21
|
//# sourceMappingURL=instantiate.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"instantiate.d.ts","sourceRoot":"","sources":["../../src/service/instantiate.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;
|
|
1
|
+
{"version":3,"file":"instantiate.d.ts","sourceRoot":"","sources":["../../src/service/instantiate.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAIpD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,OAAO,sBAAsB,EAAE,aAAa,CAAA;IACvD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,GAAG,CAAC,EAAE,cAAc,aAAa,EAAE,GAAG,CAAA;CACvC;AAaD;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAE1C,UAAU,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,EACvC,IAAI,EAAE,WAAW,EACjB,iBAAiB,CAAC,EAAE,kBAAkB,EACtC,MAAM,CAAC,EAAE,WAAW,EACpB,WAAW,CAAC,EAAE,yBAAyB,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwJzB"}
|
|
@@ -32,7 +32,7 @@ function buildEventNames(modelName) {
|
|
|
32
32
|
*/
|
|
33
33
|
export function instantiateServiceDescriptor(
|
|
34
34
|
// biome-ignore lint/suspicious/noExplicitAny: generic descriptor
|
|
35
|
-
descriptor, repo, messageAggregator, logger) {
|
|
35
|
+
descriptor, repo, messageAggregator, logger, runtimeData) {
|
|
36
36
|
const entityName = descriptor.entity.name;
|
|
37
37
|
const plural = pluralize(entityName);
|
|
38
38
|
const events = buildEventNames(entityName);
|
|
@@ -131,7 +131,14 @@ descriptor, repo, messageAggregator, logger) {
|
|
|
131
131
|
return noopLogger;
|
|
132
132
|
},
|
|
133
133
|
};
|
|
134
|
-
const customMethods = descriptor.factory({
|
|
134
|
+
const customMethods = descriptor.factory({
|
|
135
|
+
db: snapshotRepo,
|
|
136
|
+
drizzle: runtimeData?.drizzle,
|
|
137
|
+
schema: runtimeData?.schema ?? {},
|
|
138
|
+
database: runtimeData?.database,
|
|
139
|
+
sql: runtimeData?.sql,
|
|
140
|
+
log: logger ?? noopLogger,
|
|
141
|
+
});
|
|
135
142
|
Object.assign(svc, customMethods);
|
|
136
143
|
// ===== Metadata for introspection (AI, query endpoint, etc.) =====
|
|
137
144
|
svc.__entity = descriptor.entity;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"instantiate.js","sourceRoot":"","sources":["../../src/service/instantiate.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,EAAE;AACF,aAAa;AACb,gFAAgF;AAChF,mEAAmE;AACnE,sFAAsF;AACtF,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,qCAAqC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAOrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;
|
|
1
|
+
{"version":3,"file":"instantiate.js","sourceRoot":"","sources":["../../src/service/instantiate.ts"],"names":[],"mappings":"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"}
|
package/docs/03-services.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
**1 entity = 1 service. Always.**
|
|
6
6
|
|
|
7
|
-
A service defines the mutations (writes) for **one** entity.
|
|
7
|
+
A service defines the mutations (writes) for **one** entity. It receives the generated repository for compensated CRUD and the schema-aware Drizzle client for explicit SQL-shaped writes. A service should own one entity's invariants; if you need to coordinate multiple entities, write a command that orchestrates the services or use a transaction deliberately.
|
|
8
8
|
|
|
9
9
|
A module can have multiple entities, and therefore multiple services. If you need to mutate two entities together, write a module command that orchestrates them.
|
|
10
10
|
|
|
@@ -13,23 +13,26 @@ If you don't have an entity, you don't have a module. Use `app.infra.*` for infr
|
|
|
13
13
|
## defineService()
|
|
14
14
|
|
|
15
15
|
```typescript
|
|
16
|
-
|
|
16
|
+
import { eq } from 'drizzle-orm'
|
|
17
|
+
|
|
18
|
+
export default defineService('product', ({ db, drizzle, schema, log }) => ({
|
|
17
19
|
activate: async (id: string) => {
|
|
18
|
-
await
|
|
20
|
+
await drizzle.update(schema.products).set({ status: 'active' }).where(eq(schema.products.id, id))
|
|
19
21
|
log.info(`Product ${id} activated`)
|
|
20
22
|
},
|
|
21
23
|
|
|
22
24
|
archive: async (id: string) => {
|
|
25
|
+
// Generated repository remains useful for simple compensated CRUD.
|
|
23
26
|
await db.update({ id, status: 'archived' })
|
|
24
27
|
log.info(`Product ${id} archived`)
|
|
25
28
|
},
|
|
26
29
|
}))
|
|
27
30
|
```
|
|
28
31
|
|
|
29
|
-
**Signature:** `defineService(entityName: string, factory: ({ db, log }) => Methods, options?)`
|
|
32
|
+
**Signature:** `defineService(entityName: string, factory: ({ db, drizzle, schema, database, sql, log }) => Methods, options?)`
|
|
30
33
|
|
|
31
34
|
- `entityName` — Entity name as a string (autocompletes from codegen)
|
|
32
|
-
- `factory` — Receives
|
|
35
|
+
- `factory` — Receives the typed repository, Drizzle runtime, generated schema, database adapter, SQL helper, and logger
|
|
33
36
|
- `options.publicMethods` — (optional) Array of method names visible to other modules
|
|
34
37
|
|
|
35
38
|
No imports needed — `defineService` is a global. Compensation is automatic — the repo snapshots state before every mutation. No `service.method()` wrapper needed.
|
|
@@ -67,6 +70,21 @@ activate: async (id: string) => {
|
|
|
67
70
|
|
|
68
71
|
**How it works:** The framework auto-snapshots repository state before every mutation. In a workflow, if step 3 fails, steps 1 and 2 are automatically rolled back using the snapshots. You don't write compensation logic — the framework handles it.
|
|
69
72
|
|
|
73
|
+
## Data APIs in services
|
|
74
|
+
|
|
75
|
+
Use `drizzle`, `schema`, and `sql` when the mutation is easier to express as SQL/Drizzle, needs custom predicates, bulk operations, joins, or transaction-shaped code.
|
|
76
|
+
|
|
77
|
+
Use `db` for simple generated CRUD that should participate in the repository snapshot compensation path.
|
|
78
|
+
|
|
79
|
+
```typescript
|
|
80
|
+
const products = schema.products
|
|
81
|
+
|
|
82
|
+
await drizzle
|
|
83
|
+
.update(products)
|
|
84
|
+
.set({ status: 'archived', updated_at: new Date() })
|
|
85
|
+
.where(eq(products.id, id))
|
|
86
|
+
```
|
|
87
|
+
|
|
70
88
|
## TypedRepository — the db API
|
|
71
89
|
|
|
72
90
|
The `db` parameter is a `TypedRepository<T>` where `T` is the inferred entity type:
|
package/docs/06-queries.md
CHANGED
|
@@ -1,14 +1,17 @@
|
|
|
1
|
-
# Queries — defineQuery()
|
|
1
|
+
# Queries — Drizzle-first defineQuery()
|
|
2
2
|
|
|
3
|
-
Queries are the CQRS read side. They expose data as GET endpoints.
|
|
3
|
+
Queries are the CQRS read side. They expose data as GET endpoints.
|
|
4
4
|
|
|
5
|
-
- `defineQuery()`
|
|
6
|
-
- `defineQueryGraph()`
|
|
5
|
+
- `defineQuery()` is the primary application API. New code should query with the schema-aware Drizzle client.
|
|
6
|
+
- `defineQueryGraph()` is reserved for generated/admin/dynamic surfaces that need entity-level browsing.
|
|
7
|
+
|
|
8
|
+
Manta does not try to replace SQL. `defineModel()` generates the Drizzle schema and migrations; `defineQuery()` gives handlers the Drizzle client, generated schema, tagged SQL helper, auth context, logging, and request headers.
|
|
7
9
|
|
|
8
10
|
## defineQuery()
|
|
9
11
|
|
|
10
12
|
```typescript
|
|
11
13
|
// src/queries/admin/list-products.ts
|
|
14
|
+
import { eq } from 'drizzle-orm'
|
|
12
15
|
import { z } from 'zod'
|
|
13
16
|
|
|
14
17
|
export default defineQuery({
|
|
@@ -18,12 +21,19 @@ export default defineQuery({
|
|
|
18
21
|
status: z.string().optional(),
|
|
19
22
|
...listParams(),
|
|
20
23
|
}),
|
|
21
|
-
handler: async (input, {
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
24
|
+
handler: async (input, { drizzle, schema, sql }) => {
|
|
25
|
+
const products = schema.products
|
|
26
|
+
return drizzle
|
|
27
|
+
.select({
|
|
28
|
+
id: products.id,
|
|
29
|
+
title: products.title,
|
|
30
|
+
status: products.status,
|
|
31
|
+
totalVariants: sql<number>`count(*) over()::int`,
|
|
32
|
+
})
|
|
33
|
+
.from(products)
|
|
34
|
+
.where(input.status ? eq(products.status, input.status) : undefined)
|
|
35
|
+
.limit(input.limit)
|
|
36
|
+
.offset(input.offset)
|
|
27
37
|
},
|
|
28
38
|
})
|
|
29
39
|
```
|
|
@@ -43,14 +53,21 @@ defineQuery({
|
|
|
43
53
|
|
|
44
54
|
```typescript
|
|
45
55
|
{
|
|
46
|
-
|
|
56
|
+
drizzle: unknown, // schema-aware Drizzle client
|
|
57
|
+
db: unknown, // alias for drizzle
|
|
58
|
+
schema: Record<string, unknown>, // generated Drizzle tables
|
|
59
|
+
sql: typeof import('drizzle-orm').sql, // tagged SQL helper
|
|
60
|
+
database: IDatabasePort, // raw SQL, pool, transactions
|
|
61
|
+
query: QueryService, // generated/admin query graph
|
|
47
62
|
log: ILoggerPort, // Structured logging
|
|
48
63
|
auth: AuthContext | null, // Authenticated user
|
|
49
64
|
headers: Record<string, string | undefined>, // Raw request headers
|
|
50
65
|
}
|
|
51
66
|
```
|
|
52
67
|
|
|
53
|
-
|
|
68
|
+
Prefer Drizzle for all application reads, including simple lists, dashboards, analytics, counts, search, and joins. Use `sql` fragments when a PostgreSQL feature is clearer than query-builder syntax.
|
|
69
|
+
|
|
70
|
+
`query.graph()` remains available for generated admin screens and dynamic entity browsing. It must not be used to hide analytical work in JavaScript. If a query needs `COUNT`, `SUM`, `GROUP BY`, `FILTER`, CTEs, window functions, full-text search, or dashboard KPIs, write it as Drizzle/SQL in `defineQuery()`.
|
|
54
71
|
|
|
55
72
|
### Routing
|
|
56
73
|
|
|
@@ -65,6 +82,18 @@ Query parameters are passed as URL query string:
|
|
|
65
82
|
GET /api/admin/list-products?status=active&limit=10&offset=0
|
|
66
83
|
```
|
|
67
84
|
|
|
85
|
+
### Serverless fast routes
|
|
86
|
+
|
|
87
|
+
For serverless and worker builds, Manta generates route-level functions for compatible `defineQuery()` files. These fast routes do not import `bootstrapApp()`, jobs, workflows, AI, command registries, or the catch-all Manta adapter.
|
|
88
|
+
|
|
89
|
+
Fast routes are generated when:
|
|
90
|
+
|
|
91
|
+
- the project uses filesystem V2 contexts (`src/queries/{context}`), not legacy `src/contexts/*.ts`
|
|
92
|
+
- the file exports `defineQuery()`, not `defineQueryGraph()`
|
|
93
|
+
- the query does not call `query.graph()`, `query.graphAndCount()`, `query.index()`, or `query.gql()`
|
|
94
|
+
|
|
95
|
+
Pure synthetic queries do not initialize the database or generated schema. Queries that reference `drizzle`, `db`, `schema`, or `database` initialize only the DB adapter and generated Drizzle schema needed by the handler.
|
|
96
|
+
|
|
68
97
|
### Input helpers
|
|
69
98
|
|
|
70
99
|
```typescript
|
|
@@ -85,22 +114,24 @@ z.object({
|
|
|
85
114
|
### Auth in queries
|
|
86
115
|
|
|
87
116
|
```typescript
|
|
88
|
-
handler: async (input, {
|
|
117
|
+
handler: async (input, { drizzle, schema, auth }) => {
|
|
89
118
|
// auth.id — user ID
|
|
90
119
|
// auth.type — context ('admin', 'customer')
|
|
91
120
|
// auth.email — user email
|
|
92
121
|
|
|
93
122
|
// Example: only return MY orders
|
|
94
|
-
return
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
123
|
+
return drizzle
|
|
124
|
+
.select()
|
|
125
|
+
.from(schema.orders)
|
|
126
|
+
.where(eq(schema.orders.customer_id, auth!.id))
|
|
98
127
|
}
|
|
99
128
|
```
|
|
100
129
|
|
|
101
130
|
## defineQueryGraph()
|
|
102
131
|
|
|
103
|
-
Exposes the query graph to the frontend. The frontend can compose
|
|
132
|
+
Exposes the query graph to the frontend. The frontend can compose entity browsing queries for generated/admin screens.
|
|
133
|
+
|
|
134
|
+
Do not use the graph as the main application query language. It is intentionally less expressive than SQL. Complex reads belong in `defineQuery()` with Drizzle.
|
|
104
135
|
|
|
105
136
|
### Wildcard — full access (admin/AI)
|
|
106
137
|
|
|
@@ -163,11 +194,11 @@ POST /api/admin/graph
|
|
|
163
194
|
|
|
164
195
|
| Use case | Primitive | Why |
|
|
165
196
|
|----------|-----------|-----|
|
|
166
|
-
|
|
|
167
|
-
| Storefront
|
|
168
|
-
|
|
|
169
|
-
|
|
|
170
|
-
| API
|
|
197
|
+
| Generated admin entity table | `defineQueryGraph('*')` | Dynamic browsing over known entities |
|
|
198
|
+
| Storefront catalog | `defineQuery` | Stable contract, optimized Drizzle query |
|
|
199
|
+
| Customer orders | `defineQuery` | Auth-scoped SQL with explicit filters |
|
|
200
|
+
| Dashboard / analytics | `defineQuery` | Aggregations run in Postgres |
|
|
201
|
+
| Third-party API | `defineQuery` | Fixed contract, no graph exposure |
|
|
171
202
|
|
|
172
203
|
## extendQueryGraph() — external entity resolvers
|
|
173
204
|
|
package/docs/15-hosts.md
CHANGED
|
@@ -17,6 +17,8 @@ Manta ships with a Nitro host (`packages/host-nitro/`). It:
|
|
|
17
17
|
- Handles the catch-all route `server/routes/[...].ts`
|
|
18
18
|
- Passes requests through to Manta's 12-step pipeline
|
|
19
19
|
|
|
20
|
+
For serverless and worker production builds, Nitro also receives generated route-level `defineQuery()` handlers under `server/routes/api/{context}/{query}.ts` when the query is compatible with the fast runtime. Those handlers bypass the catch-all route and do not call `bootstrapApp()`. The catch-all remains the fallback for command graphs, query graphs, workflows, custom API routes, auth routes, cron routes, and legacy context setups.
|
|
21
|
+
|
|
20
22
|
## Creating a custom host
|
|
21
23
|
|
|
22
24
|
### Example: Express host
|