core-services-sdk 1.3.82 → 1.3.83

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-services-sdk",
-  "version": "1.3.82",
+  "version": "1.3.83",
   "main": "src/index.js",
   "type": "module",
   "types": "types/index.d.ts",

package/src/http/http.js

@@ -24,6 +24,7 @@
  * @property {string} url - The URL to send the request to.
  * @property {any} body - The request body to send.
  * @property {Record<string, string>} [headers] - Optional HTTP headers.
+ * @property {RequestInit} [extraParams] - Additional fetch options.
  * @property {ResponseTypeValue} [expectedType] - Expected response type.
  */
 
@@ -32,6 +33,7 @@
  * @property {string} url - The URL to send the request to.
  * @property {any} body - The request body to send.
  * @property {Record<string, string>} [headers] - Optional HTTP headers.
+ * @property {RequestInit} [extraParams] - Additional fetch options.
  * @property {ResponseTypeValue} [expectedType] - Expected response type.
  */
 
@@ -40,6 +42,7 @@
  * @property {string} url - The URL to send the request to.
  * @property {any} body - The request body to send.
  * @property {Record<string, string>} [headers] - Optional HTTP headers.
+ * @property {RequestInit} [extraParams] - Additional fetch options.
  * @property {ResponseTypeValue} [expectedType] - Expected response type.
  */
 
@@ -48,6 +51,7 @@
  * @property {string} url - The URL to send the request to.
  * @property {any} [body] - Optional request body to send.
  * @property {Record<string, string>} [headers] - Optional HTTP headers.
+ * @property {RequestInit} [extraParams] - Additional fetch options.
  * @property {ResponseTypeValue} [expectedType] - Expected response type.
  */
 
@@ -205,9 +209,11 @@ export const post = async ({
   url,
   body,
   headers = {},
+  extraParams = {},
   expectedType = ResponseType.json,
 }) => {
   const response = await fetch(url, {
+    ...extraParams,
     method: HTTP_METHODS.POST,
     headers: { ...JSON_HEADER, ...headers },
     body: JSON.stringify(body),
@@ -227,9 +233,11 @@ export const put = async ({
   url,
   body,
   headers = {},
+  extraParams = {},
   expectedType = ResponseType.json,
 }) => {
   const response = await fetch(url, {
+    ...extraParams,
     method: HTTP_METHODS.PUT,
     headers: { ...JSON_HEADER, ...headers },
     body: expectedType === ResponseType.json ? JSON.stringify(body) : body,
@@ -249,9 +257,11 @@ export const patch = async ({
   url,
   body,
   headers = {},
+  extraParams = {},
   expectedType = ResponseType.json,
 }) => {
   const response = await fetch(url, {
+    ...extraParams,
     method: HTTP_METHODS.PATCH,
     headers: { ...JSON_HEADER, ...headers },
     body: JSON.stringify(body),
@@ -271,9 +281,11 @@ export const deleteApi = async ({
   url,
   body,
   headers = {},
+  extraParams = {},
   expectedType = ResponseType.json,
 }) => {
   const response = await fetch(url, {
+    ...extraParams,
     method: HTTP_METHODS.DELETE,
     headers: { ...JSON_HEADER, ...headers },
     ...(body ? { body: JSON.stringify(body) } : {}),

package/tests/http/http.unit.test.js

@@ -185,3 +185,73 @@ describe('http client (native fetch)', () => {
     })
   })
 })
+
+describe('extraParams support', () => {
+  it('should pass extraParams to fetch in GET', async () => {
+    mockFetch.mockResolvedValueOnce(
+      createMockResponse({ body: JSON.stringify({ ok: true }) }),
+    )
+
+    const controller = new AbortController()
+
+    await http.get({
+      url: 'http://test.com',
+      extraParams: {
+        signal: controller.signal,
+        redirect: 'follow',
+      },
+    })
+
+    expect(mockFetch).toHaveBeenCalledWith(
+      'http://test.com',
+      expect.objectContaining({
+        method: HTTP_METHODS.GET,
+        signal: controller.signal,
+        redirect: 'follow',
+      }),
+    )
+  })
+
+  it('should pass extraParams to fetch in POST', async () => {
+    mockFetch.mockResolvedValueOnce(
+      createMockResponse({ body: JSON.stringify({ ok: true }) }),
+    )
+
+    await http.post({
+      url: 'http://test.com',
+      body: { a: 1 },
+      extraParams: {
+        credentials: 'include',
+      },
+    })
+
+    expect(mockFetch).toHaveBeenCalledWith(
+      'http://test.com',
+      expect.objectContaining({
+        method: HTTP_METHODS.POST,
+        credentials: 'include',
+      }),
+    )
+  })
+
+  it('should pass extraParams to fetch in DELETE', async () => {
+    mockFetch.mockResolvedValueOnce(
+      createMockResponse({ body: JSON.stringify({ ok: true }) }),
+    )
+
+    await http.deleteApi({
+      url: 'http://test.com',
+      extraParams: {
+        keepalive: true,
+      },
+    })
+
+    expect(mockFetch).toHaveBeenCalledWith(
+      'http://test.com',
+      expect.objectContaining({
+        method: HTTP_METHODS.DELETE,
+        keepalive: true,
+      }),
+    )
+  })
+})

package/types/http/http.d.ts

@@ -3,60 +3,157 @@ export function get({
   headers,
   extraParams,
   expectedType,
-}: {
-  url: any
-  headers?: {}
-  extraParams?: {}
-  expectedType?: 'json'
-}): Promise<any>
+}: HttpGetOptions): Promise<any>
 export function post({
   url,
   body,
   headers,
+  extraParams,
   expectedType,
-}: {
-  url: any
-  body: any
-  headers?: {}
-  expectedType?: 'json'
-}): Promise<any>
+}: HttpPostOptions): Promise<any>
 export function put({
   url,
   body,
   headers,
+  extraParams,
   expectedType,
-}: {
-  url: any
-  body: any
-  headers?: {}
-  expectedType?: 'json'
-}): Promise<any>
+}: HttpPutOptions): Promise<any>
 export function patch({
   url,
   body,
   headers,
+  extraParams,
   expectedType,
-}: {
-  url: any
-  body: any
-  headers?: {}
-  expectedType?: 'json'
-}): Promise<any>
+}: HttpPatchOptions): Promise<any>
 export function deleteApi({
   url,
   body,
   headers,
+  extraParams,
   expectedType,
-}: {
-  url: any
+}: HttpDeleteOptions): Promise<any>
+/**
+ * Consolidated HTTP client with methods for common HTTP operations.
+ *
+ * @type {{
+ *   get: (options: HttpGetOptions) => Promise<any>,
+ *   put: (options: HttpPutOptions) => Promise<any>,
+ *   post: (options: HttpPostOptions) => Promise<any>,
+ *   patch: (options: HttpPatchOptions) => Promise<any>,
+ *   deleteApi: (options: HttpDeleteOptions) => Promise<any>
+ * }}
+ */
+export const http: {
+  get: (options: HttpGetOptions) => Promise<any>
+  put: (options: HttpPutOptions) => Promise<any>
+  post: (options: HttpPostOptions) => Promise<any>
+  patch: (options: HttpPatchOptions) => Promise<any>
+  deleteApi: (options: HttpDeleteOptions) => Promise<any>
+}
+export type ResponseTypeValue = 'json' | 'xml' | 'text' | 'raw' | 'file'
+export type HttpGetOptions = {
+  /**
+   * - The URL to send the request to.
+   */
+  url: string
+  /**
+   * - Optional HTTP headers.
+   */
+  headers?: Record<string, string>
+  /**
+   * - Additional fetch options.
+   */
+  extraParams?: RequestInit
+  /**
+   * - Expected response type.
+   */
+  expectedType?: ResponseTypeValue
+}
+export type HttpPostOptions = {
+  /**
+   * - The URL to send the request to.
+   */
+  url: string
+  /**
+   * - The request body to send.
+   */
+  body: any
+  /**
+   * - Optional HTTP headers.
+   */
+  headers?: Record<string, string>
+  /**
+   * - Additional fetch options.
+   */
+  extraParams?: RequestInit
+  /**
+   * - Expected response type.
+   */
+  expectedType?: ResponseTypeValue
+}
+export type HttpPutOptions = {
+  /**
+   * - The URL to send the request to.
+   */
+  url: string
+  /**
+   * - The request body to send.
+   */
   body: any
-  headers?: {}
-  expectedType?: 'json'
-}): Promise<any>
-export namespace http {
-  export { get }
-  export { put }
-  export { post }
-  export { patch }
-  export { deleteApi }
+  /**
+   * - Optional HTTP headers.
+   */
+  headers?: Record<string, string>
+  /**
+   * - Additional fetch options.
+   */
+  extraParams?: RequestInit
+  /**
+   * - Expected response type.
+   */
+  expectedType?: ResponseTypeValue
+}
+export type HttpPatchOptions = {
+  /**
+   * - The URL to send the request to.
+   */
+  url: string
+  /**
+   * - The request body to send.
+   */
+  body: any
+  /**
+   * - Optional HTTP headers.
+   */
+  headers?: Record<string, string>
+  /**
+   * - Additional fetch options.
+   */
+  extraParams?: RequestInit
+  /**
+   * - Expected response type.
+   */
+  expectedType?: ResponseTypeValue
+}
+export type HttpDeleteOptions = {
+  /**
+   * - The URL to send the request to.
+   */
+  url: string
+  /**
+   * - Optional request body to send.
+   */
+  body?: any
+  /**
+   * - Optional HTTP headers.
+   */
+  headers?: Record<string, string>
+  /**
+   * - Additional fetch options.
+   */
+  extraParams?: RequestInit
+  /**
+   * - Expected response type.
+   */
+  expectedType?: ResponseTypeValue
 }

package/types/postgresql/index.d.ts

@@ -5,4 +5,6 @@ export * from './filters/apply-filter.js'
 export * from './modifiers/apply-order-by.js'
 export * from './start-stop-postgres-docker.js'
 export * from './modifiers/apply-pagination.js'
+export * from './repositories/BaseRepository.js'
 export * from './filters/apply-filter-snake-case.js'
+export * from './repositories/TenantScopedRepository.js'

package/types/postgresql/pagination/paginate.d.ts

@@ -69,6 +69,7 @@ export function sqlPaginate({
   limit,
   filter,
   snakeCase,
+  distinctOn,
 }: {
   baseQuery: import('knex').Knex.QueryBuilder
   filter?: any

package/types/postgresql/repositories/BaseRepository.d.ts

@@ -0,0 +1,50 @@
+/**
+ * BaseRepository
+ *
+ * Provides:
+ * - tableName getter (static + instance support)
+ * - baseQuery(options)
+ * - constructor-level query shaping (optional)
+ * - generic find() with pagination
+ *
+ * Does NOT enforce tenant isolation.
+ */
+export class BaseRepository {
+  constructor({ db, log, baseQueryBuilder }?: {})
+  db: any
+  log: any
+  _baseQueryBuilder: any
+  /**
+   * Each concrete repository must define:
+   * static tableName = 'table_name'
+   */
+  get tableName(): any
+  /**
+   * Builds the base knex query.
+   * Applies constructor-level baseQueryBuilder if provided.
+   */
+  baseQuery(options: {}, params: any): any
+  /**
+   * Generic paginated find
+   */
+  find({
+    page,
+    limit,
+    filter,
+    orderBy,
+    options,
+    mapRow,
+    ...restParams
+  }: {
+    [x: string]: any
+    page?: number
+    limit?: number
+    filter?: {}
+    orderBy?: {
+      column: string
+      direction: string
+    }
+    options?: {}
+    mapRow?: (row: any) => any
+  }): Promise<any>
+}

package/types/postgresql/repositories/TenantScopedRepository.d.ts

@@ -0,0 +1,11 @@
+export class TenantScopedRepository extends BaseRepository {
+  /**
+   * Extracts and validates tenantId from filter
+   */
+  getRequiredTenantId(filter?: {}): any
+  /**
+   * Overrides find to enforce tenant presence
+   */
+  find(params?: {}): Promise<any>
+}
+import { BaseRepository } from './BaseRepository.js'