@zintrust/core 0.4.98 → 0.4.101

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zintrust/core",
3
- "version": "0.4.98",
3
+ "version": "0.4.101",
4
4
  "description": "Production-grade TypeScript backend framework for JavaScript",
5
5
  "homepage": "https://zintrust.com",
6
6
  "repository": {
@@ -215,7 +215,7 @@ const warnIfAdapterMissing = (cmd, conn) => {
215
215
  if (conn.driver === 'mysql' && DatabaseAdapterRegistry.get('mysql') === undefined) {
216
216
  cmd.warn('MySQL adapter is not installed/registered; migrations may not hit a real MySQL DB.');
217
217
  cmd.warn('Install via `zin plugin install adapter:mysql` (or `zin add db:mysql`).');
218
- cmd.debug('[debug] Expected a side-effect import in src/zintrust.plugins.ts like: import "../../../packages/db-mysql/src/register";');
218
+ cmd.debug('[debug] Expected a side-effect import in src/zintrust.plugins.ts like: import "@zintrust/db-mysql/register";');
219
219
  }
220
220
  if (conn.driver === 'postgresql' && DatabaseAdapterRegistry.get('postgresql') === undefined) {
221
221
  cmd.warn('PostgreSQL adapter is not installed/registered; migrations may not hit a real PostgreSQL DB.');
@@ -18,7 +18,7 @@ export declare const validateRequiredParams: (params: Record<string, unknown>, r
18
18
  * Create standardized API error response
19
19
  */
20
20
  export declare const createApiError: (message: string, service: string) => Error;
21
- export declare const tracedFetch: (url: string, options: RequestInit, _trace?: TracedFetchTraceOptions) => Promise<Response>;
21
+ export declare const tracedFetch: (url: string, options: RequestInit, trace?: TracedFetchTraceOptions) => Promise<Response>;
22
22
  /**
23
23
  * Common fetch wrapper with error handling
24
24
  */
@@ -1 +1 @@
1
- {"version":3,"file":"ExternalServiceUtils.d.ts","sourceRoot":"","sources":["../../../src/common/ExternalServiceUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,iBAAa,KAAG,MAe1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,MAAM,EAAE,KACjB,IAWF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,KAEjE,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,SAAS,uBAAuB,KAC/B,OAAO,CAAC,QAAQ,CAElB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,QAAQ,CAclB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAChC,SAAS,OAAO,EAChB,OAAO,CAAC,EACR,QAAQ,MAAM,KACb;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAY9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;iBACU,MAAM;IAMnB;;OAEG;oBACa,MAAM;IAItB;;OAEG;8BACuB,MAAM,GAAG,OAAO;IAI1C;;OAEG;gCAEO,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,eACpD,MAAM,UACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;IAYjC;;OAEG;+BAEO,WAAW,GAAG,WAAW,eACpB,MAAM,SACZ,KAAK,UACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;CASlC,CAAC"}
1
+ {"version":3,"file":"ExternalServiceUtils.d.ts","sourceRoot":"","sources":["../../../src/common/ExternalServiceUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAkHF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,iBAAa,KAAG,MAe1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,MAAM,EAAE,KACjB,IAWF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,KAEjE,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,QAAQ,CAWlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,QAAQ,CAclB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAChC,SAAS,OAAO,EAChB,OAAO,CAAC,EACR,QAAQ,MAAM,KACb;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAY9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;iBACU,MAAM;IAMnB;;OAEG;oBACa,MAAM;IAItB;;OAEG;8BACuB,MAAM,GAAG,OAAO;IAI1C;;OAEG;gCAEO,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,eACpD,MAAM,UACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;IAYjC;;OAEG;+BAEO,WAAW,GAAG,WAAW,eACpB,MAAM,SACZ,KAAK,UACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;CASlC,CAAC"}
@@ -2,8 +2,92 @@
2
2
  * Shared Utilities for External Service Drivers
3
3
  * Common patterns for API calls, environment variable reading, and error handling
4
4
  */
5
+ import { SystemTraceBridge } from '../trace/SystemTraceBridge.js';
5
6
  import { Env } from '../config/env.js';
6
7
  import { ErrorFactory } from '../exceptions/ZintrustError.js';
8
+ const isHeaderEntriesLike = (value) => {
9
+ return typeof value === 'object' && value !== null && 'entries' in value;
10
+ };
11
+ const isHeaderTuple = (value) => {
12
+ return (Array.isArray(value) &&
13
+ value.length === 2 &&
14
+ typeof value[0] === 'string' &&
15
+ typeof value[1] === 'string');
16
+ };
17
+ const isHeaderTupleArray = (value) => {
18
+ return Array.isArray(value) && value.every(isHeaderTuple);
19
+ };
20
+ const asHeadersInitLocal = (headers) => {
21
+ return headers;
22
+ };
23
+ const asBodyInitLocal = (body) => {
24
+ return body;
25
+ };
26
+ const headersToRecord = (headers) => {
27
+ if (headers === undefined)
28
+ return {};
29
+ if (headers instanceof Headers) {
30
+ return Object.fromEntries(headers.entries());
31
+ }
32
+ if (isHeaderEntriesLike(headers)) {
33
+ return Object.fromEntries(headers.entries());
34
+ }
35
+ if (isHeaderTupleArray(headers)) {
36
+ return Object.fromEntries(headers);
37
+ }
38
+ return Object.fromEntries(Object.entries(headers).filter((entry) => typeof entry[1] === 'string'));
39
+ };
40
+ const bodyToTracePayload = (body) => {
41
+ if (body === null || body === undefined)
42
+ return undefined;
43
+ if (typeof body === 'string') {
44
+ try {
45
+ return JSON.parse(body);
46
+ }
47
+ catch {
48
+ return body;
49
+ }
50
+ }
51
+ if (body instanceof URLSearchParams) {
52
+ return body.toString();
53
+ }
54
+ if (typeof FormData !== 'undefined' &&
55
+ body instanceof FormData &&
56
+ typeof body.entries === 'function') {
57
+ return Array.from(body.entries()).map(([key, value]) => [key, String(value)]);
58
+ }
59
+ return '[stream]';
60
+ };
61
+ const captureResponseBody = async (response) => {
62
+ try {
63
+ return await response.clone().text();
64
+ }
65
+ catch {
66
+ return undefined;
67
+ }
68
+ };
69
+ const emitTrace = async (url, options, trace, duration, response, error) => {
70
+ const responseBody = response ? await captureResponseBody(response) : undefined;
71
+ let traceError;
72
+ if (error instanceof Error) {
73
+ traceError = error.message;
74
+ }
75
+ else if (error !== undefined) {
76
+ traceError = String(error);
77
+ }
78
+ SystemTraceBridge.emitHttpClient({
79
+ source: trace?.source,
80
+ method: String(options.method ?? 'GET').toUpperCase(),
81
+ url,
82
+ requestHeaders: headersToRecord(asHeadersInitLocal(options.headers)),
83
+ responseStatus: response?.status,
84
+ duration,
85
+ requestBody: bodyToTracePayload(asBodyInitLocal(options.body)),
86
+ responseHeaders: headersToRecord(response?.headers),
87
+ responseBody,
88
+ error: traceError,
89
+ });
90
+ };
7
91
  /**
8
92
  * Environment variable reader with fallback support
9
93
  * Handles both Env.get() and process.env for maximum compatibility
@@ -44,8 +128,17 @@ export const validateRequiredParams = (params, required) => {
44
128
  export const createApiError = (message, service) => {
45
129
  return ErrorFactory.createValidationError(`${service} API error: ${message}`);
46
130
  };
47
- export const tracedFetch = async (url, options, _trace) => {
48
- return globalThis.fetch(url, options);
131
+ export const tracedFetch = async (url, options, trace) => {
132
+ const startTime = Date.now();
133
+ try {
134
+ const response = await globalThis.fetch(url, options);
135
+ await emitTrace(url, options, trace, Date.now() - startTime, response);
136
+ return response;
137
+ }
138
+ catch (error) {
139
+ await emitTrace(url, options, trace, Date.now() - startTime, undefined, error);
140
+ throw error;
141
+ }
49
142
  };
50
143
  /**
51
144
  * Common fetch wrapper with error handling
package/src/index.js CHANGED
@@ -1,11 +1,11 @@
1
1
  /**
2
- * @zintrust/core v0.4.98
2
+ * @zintrust/core v0.4.101
3
3
  *
4
4
  * ZinTrust Framework - Production-Grade TypeScript Backend
5
5
  * Built for performance, type safety, and exceptional developer experience
6
6
  *
7
7
  * Build Information:
8
- * Built: 2026-04-12T07:36:38.129Z
8
+ * Built: 2026-04-12T14:05:19.317Z
9
9
  * Node: >=20.0.0
10
10
  * License: MIT
11
11
  *
@@ -21,7 +21,7 @@
21
21
  * Available at runtime for debugging and health checks
22
22
  */
23
23
  export const ZINTRUST_VERSION = '0.1.41';
24
- export const ZINTRUST_BUILD_DATE = '2026-04-12T07:36:38.086Z'; // Replaced during build
24
+ export const ZINTRUST_BUILD_DATE = '2026-04-12T14:05:19.285Z'; // Replaced during build
25
25
  export { Application } from './boot/Application.js';
26
26
  export { AwsSigV4 } from './common/index.js';
27
27
  export { SignedRequest } from './security/SignedRequest.js';
@@ -1,10 +1,7 @@
1
1
  /**
2
- * ZinTrust plugin auto-imports
3
- *
4
- * In real projects, this file is managed by `zin plugin install` and contains
5
- * side-effect imports (e.g. `@zintrust/db-sqlite/register`) that register
6
- * optional adapters/drivers into core registries.
7
- *
2
+ * Auto-generated fallback module.
3
+ * This file is created by scripts/ensure-worker-plugins.mjs when missing.
4
+ * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
8
5
  */
9
6
  export type {};
10
7
  export declare const __zintrustGeneratedPluginStub = "zintrust.plugins.ts";
@@ -1 +1 @@
1
- {"version":3,"file":"zintrust.plugins.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,YAAY,EAAE,CAAC;AAgBf,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}
1
+ {"version":3,"file":"zintrust.plugins.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,YAAY,EAAE,CAAC;AAgBf,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}
@@ -1,10 +1,7 @@
1
1
  /**
2
- * ZinTrust plugin auto-imports
3
- *
4
- * In real projects, this file is managed by `zin plugin install` and contains
5
- * side-effect imports (e.g. `@zintrust/db-sqlite/register`) that register
6
- * optional adapters/drivers into core registries.
7
- *
2
+ * Auto-generated fallback module.
3
+ * This file is created by scripts/ensure-worker-plugins.mjs when missing.
4
+ * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
8
5
  */
9
6
  import * as TraceRuntime from './runtime/plugins/trace-runtime.js';
10
7
  globalThis.__zintrust_system_trace_plugin_requested__ = true;
@@ -1,11 +0,0 @@
1
- import '../packages/db-d1/src/register.js';
2
- import '../packages/db-mysql/src/register.js';
3
- import '../packages/db-postgres/src/register.js';
4
- import '../packages/db-sqlite/src/register.js';
5
- import '../packages/db-sqlserver/src/register.js';
6
- import '../packages/mail-sendgrid/src/register.js';
7
- import '../packages/mail-smtp/src/register.js';
8
- import '@zintrust/queue-monitor';
9
- import '../packages/queue-redis/src/register.js';
10
- import '../packages/workers/src/register.js';
11
- //# sourceMappingURL=zintrust.comon.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"zintrust.comon.d.ts","sourceRoot":"","sources":["../../src/zintrust.comon.ts"],"names":[],"mappings":"AAQA,OAAO,mCAAmC,CAAC;AAC3C,OAAO,sCAAsC,CAAC;AAC9C,OAAO,yCAAyC,CAAC;AACjD,OAAO,uCAAuC,CAAC;AAC/C,OAAO,0CAA0C,CAAC;AAClD,OAAO,2CAA2C,CAAC;AACnD,OAAO,uCAAuC,CAAC;AAC/C,OAAO,wCAAwC,CAAC;AAChD,OAAO,yCAAyC,CAAC;AACjD,OAAO,qCAAqC,CAAC"}
@@ -1,17 +0,0 @@
1
- /* eslint-disable no-restricted-imports */
2
- // /**
3
- // * ZinTrust comon plugin auto-imports
4
- // *
5
- // * This file is managed by `zin plugin install` and contains side-effect
6
- // * imports that register optional adapters/drivers into core registries.
7
- // */
8
- import '../packages/db-d1/src/register.js';
9
- import '../packages/db-mysql/src/register.js';
10
- import '../packages/db-postgres/src/register.js';
11
- import '../packages/db-sqlite/src/register.js';
12
- import '../packages/db-sqlserver/src/register.js';
13
- import '../packages/mail-sendgrid/src/register.js';
14
- import '../packages/mail-smtp/src/register.js';
15
- import '@zintrust/queue-monitor';
16
- import '../packages/queue-redis/src/register.js';
17
- import '../packages/workers/src/register.js';