arkos 2.0.0-next.26 → 2.0.0-next.28

package/dist/esm/utils/helpers/arkos-config.helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"arkos-config.helpers.js","sourceRoot":"","sources":["../../../../src/utils/helpers/arkos-config.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmB,MAAM,kBAAkB,CAAC;AACjE,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,SAAS,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,CAAC,wCAAwC,CAAC,CAAC;AAE3C,IAAI,kBAAkB,GAAQ,EAAE,CAAC;AAEjC,IAAI,CAAC;IACH,kBAAkB,GAAG,0BAA0B,CAAC;AAClD,CAAC;AAAC,OAAO,GAAQ,EAAE,CAAC;IAClB,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAC1D,IAAI,CAAC,IAAI,CACP,+CAA+C,SAAS,CAAC,oBAAoB,EAAE,gBAAgB,EAC/F;YACE,SAAS,EAAE,IAAI;SAChB,CACF,CAAC;;QACC,MAAM,GAAG,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5C,OAAO,cAAc,EAAE,IAAI,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5C,OAAO,cAAc,EAAE,IAAI,IAAI,cAAc,EAAE,OAAO,KAAK,KAAK,CAAC;AACnE,CAAC;AAOD,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GACV,OAAO,kBAAkB,KAAK,QAAQ;QACpC,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE;QAC9B,CAAC,CAAE,kBAA0B,EAAE,OAAO,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3E,MAAM,UAAU,GAAG,gBAAgB,SAAS,CAAC,oBAAoB,EAAE,EAAE,CAAC;IAEtE,IACG,MAAc,CAAC,QAAQ,KAAK,cAAc;QAE3C,OAAO,IAAI,IAAI,WAAW;QAC1B,OAAO,kBAAkB,KAAK,QAAQ,EACtC,CAAC;QACD,IAAI,CAAC,KAAK,CACR,0BAA0B,UAAU,8GAA8G,UAAU;;;;;;;CAOjK,CACI,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,YAAY,CAAC,MAAM,CAAQ,CAAC;AACrC,CAAC;AAOD,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,qBAAqB,GAAG,uBAAuB,EAAE,CAAC;IAExD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU;QAC7B,MAAM,SAAS,CACb,gHAAgH,CACjH,CAAC;IAEJ,IACE,qBAAqB;QACrB,YAAY,EAAE;QACd,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU;QACvB,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,MAAM;QAEnC,MAAM,SAAS,CACb,qHAAqH,CACtH,CAAC;IAEJ,IAAI,qBAAqB,IAAI,CAAC,iBAAiB,EAAE;QAC/C,MAAM,SAAS,CACb,2LAA2L,CAC5L,CAAC;AACN,CAAC","sourcesContent":["import { defineConfig, UserArkosConfig } from \"../define-config\";\nimport sheu from \"../sheu\";\nimport ExitError from \"./exit-error\";\nimport * as fsHelpers from \"./fs.helpers\";\nimport { getPrismaInstance } from \"./prisma.helpers\";\n(\"ReplaceWithNeededImportsForArkosConfig\"); // This will be filled by post build script\n\nlet definedArkosConfig: any = {};\n\ntry {\n  definedArkosConfig = \"ReplaceWithDynamicImport\"; // This will be filled by post build script\n} catch (err: any) {\n  if (err.message.toLowerCase().includes(\"cannot find module\"))\n    sheu.warn(\n      `Using default configs, because arkos.config.${fsHelpers.getUserFileExtension()} was not found`,\n      {\n        timestamp: true,\n      }\n    );\n  else throw err;\n}\n\nexport function isUsingAuthentication() {\n  const { authentication } = getArkosConfig();\n  return authentication?.mode;\n}\n\nexport function isAuthenticationEnabled() {\n  const { authentication } = getArkosConfig();\n  return authentication?.mode && authentication?.enabled !== false;\n}\n\n/**\n * Gives access to the underlying current configurations being used by **Arkos** by default and also loaded through `arkos.config.{ts|js}`\n *\n * @returns {ArkosConfig}\n */\nexport function getArkosConfig(): UserArkosConfig {\n  const config =\n    typeof definedArkosConfig === \"string\"\n      ? { __loader: \"defineConfig\" }\n      : (definedArkosConfig as any)?.default || { __loader: \"defineConfig\" };\n  const configFile = `arkos.config.${fsHelpers.getUserFileExtension()}`;\n\n  if (\n    (config as any).__loader !== \"defineConfig\" &&\n    //@ts-ignore\n    typeof jest == \"undefined\" &&\n    typeof definedArkosConfig === \"object\"\n  ) {\n    sheu.error(\n      `From v1.6 config under ${configFile} must be wrapped in \\`defineConfig()\\` function from \\`arkos/config\\`. You can do the following under your ${configFile}:\n\nimport { defineConfig } from \"arkos/config\"\n\nconst config = defineConfig({ ... })\n\nexport default config\n`\n    );\n    process.exit(1);\n  }\n\n  return defineConfig(config) as any;\n}\n\n/**\n * Returns true if application is being run through `arkos start` after `arkos build`\n *\n * @since 1.5.16-beta\n */\nexport function isProduction() {\n  return process.env.ARKOS_BUILD === \"true\";\n}\n\nexport function validateArkosConfig() {\n  const config = getArkosConfig();\n  const authenticationEnabled = isAuthenticationEnabled();\n\n  if (!config?.source?.entryPoint)\n    throw ExitError(\n      `Invalid value for 'arkosConfig.source.entryPoint', please pass a valid path from the current working directory`\n    );\n\n  if (\n    authenticationEnabled &&\n    isProduction() &&\n    !process.env.JWT_SECRET &&\n    !config.authentication?.jwt?.secret\n  )\n    throw ExitError(\n      `Missing jwt secret in production, see https://www.arkosjs.com/docs/core-concepts/authentication/setup#configuration`\n    );\n\n  if (authenticationEnabled && !getPrismaInstance())\n    throw ExitError(\n      `Arkos' authentication system relies on prisma instance, please disabled your authentication or see https://www.arkosjs.com/docs/core-concepts/prisma-orm/setup to setup a prisma instance`\n    );\n}\n"]}
+{"version":3,"file":"arkos-config.helpers.js","sourceRoot":"","sources":["../../../../src/utils/helpers/arkos-config.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmB,MAAM,kBAAkB,CAAC;AACjE,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,SAAS,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,CAAC,wCAAwC,CAAC,CAAC;AAE3C,IAAI,kBAAkB,GAAQ,EAAE,CAAC;AACjC,MAAM,cAAc,GAAG,gBAAgB,SAAS,CAAC,oBAAoB,EAAE,EAAE,CAAC;AAE1E,IAAI,CAAC;IACH,kBAAkB,GAAG,0BAA0B,CAAC;AAClD,CAAC;AAAC,OAAO,GAAQ,EAAE,CAAC;IAClB,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,cAAc,GAAG,CAAC;QAC1D,IAAI,CAAC,IAAI,CACP,kCAAkC,cAAc,gBAAgB,EAChE;YACE,SAAS,EAAE,IAAI;SAChB,CACF,CAAC;;QACC,MAAM,GAAG,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5C,OAAO,cAAc,EAAE,IAAI,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5C,OAAO,cAAc,EAAE,IAAI,IAAI,cAAc,EAAE,OAAO,KAAK,KAAK,CAAC;AACnE,CAAC;AAOD,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GACV,OAAO,kBAAkB,KAAK,QAAQ;QACpC,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE;QAC9B,CAAC,CAAE,kBAA0B,EAAE,OAAO,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3E,MAAM,UAAU,GAAG,gBAAgB,SAAS,CAAC,oBAAoB,EAAE,EAAE,CAAC;IAEtE,IACG,MAAc,CAAC,QAAQ,KAAK,cAAc;QAE3C,OAAO,IAAI,IAAI,WAAW;QAC1B,OAAO,kBAAkB,KAAK,QAAQ,EACtC,CAAC;QACD,IAAI,CAAC,KAAK,CACR,0BAA0B,UAAU,8GAA8G,UAAU;;;;;;;CAOjK,CACI,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,YAAY,CAAC,MAAM,CAAQ,CAAC;AACrC,CAAC;AAOD,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,qBAAqB,GAAG,uBAAuB,EAAE,CAAC;IAExD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU;QAC7B,MAAM,SAAS,CACb,gHAAgH,CACjH,CAAC;IAEJ,IACE,qBAAqB;QACrB,YAAY,EAAE;QACd,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU;QACvB,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,MAAM;QAEnC,MAAM,SAAS,CACb,qHAAqH,CACtH,CAAC;IAEJ,IAAI,qBAAqB,IAAI,CAAC,iBAAiB,EAAE;QAC/C,MAAM,SAAS,CACb,2LAA2L,CAC5L,CAAC;AACN,CAAC","sourcesContent":["import { defineConfig, UserArkosConfig } from \"../define-config\";\nimport sheu from \"../sheu\";\nimport ExitError from \"./exit-error\";\nimport * as fsHelpers from \"./fs.helpers\";\nimport { getPrismaInstance } from \"./prisma.helpers\";\n(\"ReplaceWithNeededImportsForArkosConfig\"); // This will be filled by post build script\n\nlet definedArkosConfig: any = {};\nconst configFilename = `arkos.config.${fsHelpers.getUserFileExtension()}`;\n\ntry {\n  definedArkosConfig = \"ReplaceWithDynamicImport\"; // This will be filled by post build script\n} catch (err: any) {\n  if (err.message.toLowerCase().includes(`${configFilename}'`))\n    sheu.warn(\n      `Using default configs, because ${configFilename} was not found`,\n      {\n        timestamp: true,\n      }\n    );\n  else throw err;\n}\n\nexport function isUsingAuthentication() {\n  const { authentication } = getArkosConfig();\n  return authentication?.mode;\n}\n\nexport function isAuthenticationEnabled() {\n  const { authentication } = getArkosConfig();\n  return authentication?.mode && authentication?.enabled !== false;\n}\n\n/**\n * Gives access to the underlying current configurations being used by **Arkos** by default and also loaded through `arkos.config.{ts|js}`\n *\n * @returns {ArkosConfig}\n */\nexport function getArkosConfig(): UserArkosConfig {\n  const config =\n    typeof definedArkosConfig === \"string\"\n      ? { __loader: \"defineConfig\" }\n      : (definedArkosConfig as any)?.default || { __loader: \"defineConfig\" };\n  const configFile = `arkos.config.${fsHelpers.getUserFileExtension()}`;\n\n  if (\n    (config as any).__loader !== \"defineConfig\" &&\n    //@ts-ignore\n    typeof jest == \"undefined\" &&\n    typeof definedArkosConfig === \"object\"\n  ) {\n    sheu.error(\n      `From v1.6 config under ${configFile} must be wrapped in \\`defineConfig()\\` function from \\`arkos/config\\`. You can do the following under your ${configFile}:\n\nimport { defineConfig } from \"arkos/config\"\n\nconst config = defineConfig({ ... })\n\nexport default config\n`\n    );\n    process.exit(1);\n  }\n\n  return defineConfig(config) as any;\n}\n\n/**\n * Returns true if application is being run through `arkos start` after `arkos build`\n *\n * @since 1.5.16-beta\n */\nexport function isProduction() {\n  return process.env.ARKOS_BUILD === \"true\";\n}\n\nexport function validateArkosConfig() {\n  const config = getArkosConfig();\n  const authenticationEnabled = isAuthenticationEnabled();\n\n  if (!config?.source?.entryPoint)\n    throw ExitError(\n      `Invalid value for 'arkosConfig.source.entryPoint', please pass a valid path from the current working directory`\n    );\n\n  if (\n    authenticationEnabled &&\n    isProduction() &&\n    !process.env.JWT_SECRET &&\n    !config.authentication?.jwt?.secret\n  )\n    throw ExitError(\n      `Missing jwt secret in production, see https://www.arkosjs.com/docs/core-concepts/authentication/setup#configuration`\n    );\n\n  if (authenticationEnabled && !getPrismaInstance())\n    throw ExitError(\n      `Arkos' authentication system relies on prisma instance, please disabled your authentication or see https://www.arkosjs.com/docs/core-concepts/prisma-orm/setup to setup a prisma instance`\n    );\n}\n"]}

package/dist/esm/utils/helpers/prisma.helpers.js

@@ -9,9 +9,9 @@ export function loadPrismaModule() {
     return instance;
 }
 export function handlePrismaGet(target, prop, receiver) {
-    const originalProperty = (Reflect.get(target, prop, receiver) || {});
+    const originalProperty = (Reflect.get(target, prop, receiver));
     const isModel = typeof originalProperty === "object"
-        ? "findMany" in originalProperty
+        ? "findMany" in (originalProperty || {})
         : false;
     if (isModel && originalProperty) {
         return new Proxy(originalProperty, {

package/dist/esm/utils/helpers/prisma.helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"prisma.helpers.js","sourceRoot":"","sources":["../../../../src/utils/helpers/prisma.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,IAAI,cAAc,GAAQ,IAAI,CAAC;AAEtC,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,cAAc,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC;IACpD,IAAI,CAAC,QAAQ;QACX,IAAI,CAAC,IAAI,CACP,qDAAqD,oBAAoB,EAAE,mEAAmE,EAC9I,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;IACJ,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAW,EAAE,IAAY,EAAE,QAAa;IACtE,MAAM,gBAAgB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAQ,CAAC;IAE5E,MAAM,OAAO,GACX,OAAO,gBAAgB,KAAK,QAAQ;QAClC,CAAC,CAAC,UAAU,IAAI,gBAAgB;QAChC,CAAC,CAAC,KAAK,CAAC;IAEZ,IAAI,OAAO,IAAI,gBAAgB,EAAE,CAAC;QAChC,OAAO,IAAI,KAAK,CAAC,gBAAgB,EAAE;YACjC,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa;gBACxC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAChC,WAAW,EACX,UAAU,EACV,aAAa,CACd,CAAC;gBAEF,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;oBACzC,OAAO,UAAU,GAAG,IAAW;wBAC7B,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;wBAChC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;wBAE1D,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;4BACpB,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;4BAE1B,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gCACnD,IAAI,CAAC,KAAK,CACR,sBAAsB,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAC1D,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;4BACJ,CAAC;iCAAM,CAAC;gCACN,IAAI,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;4BAC/D,CAAC;wBACH,CAAC;wBAED,OAAO,cAAc,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;oBACjD,CAAC,CAAC;gBACJ,CAAC;gBAED,OAAO,cAAc,CAAC;YACxB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,QAAQ,IAAI,EAAE,EAAE;QACzD,GAAG,EAAE,eAAe;KACrB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { getArkosConfig } from \"./arkos-config.helpers\";\nimport sheu from \"../sheu\";\nimport { getUserFileExtension } from \"./fs.helpers\";\n\nexport let prismaInstance: any = null;\n\nexport function loadPrismaModule() {\n  const instance = getArkosConfig()?.prisma?.instance;\n  if (!instance)\n    sheu.warn(\n      `Prisma client instance not passed to arkos.config.${getUserFileExtension()}, see https://www.arkosjs.com/docs/core-concepts/prisma-orm/setup`,\n      { timestamp: true }\n    );\n  return instance;\n}\n\nexport function handlePrismaGet(target: any, prop: string, receiver: any) {\n  const originalProperty = (Reflect.get(target, prop, receiver) || {}) as any;\n\n  const isModel =\n    typeof originalProperty === \"object\"\n      ? \"findMany\" in originalProperty\n      : false;\n\n  if (isModel && originalProperty) {\n    return new Proxy(originalProperty, {\n      get(modelTarget, methodName, modelReceiver) {\n        const originalMethod = Reflect.get(\n          modelTarget,\n          methodName,\n          modelReceiver\n        );\n\n        if (typeof originalMethod === \"function\") {\n          return function (...args: any[]) {\n            const config = getArkosConfig();\n            const debugLevel = config.debugging?.requests?.level || 0;\n\n            if (debugLevel >= 3) {\n              const queryArgs = args[0];\n\n              if (queryArgs && Object.keys(queryArgs).length > 0) {\n                sheu.debug(\n                  `Final Prisma Args\\n${JSON.stringify(queryArgs, null, 2)}`,\n                  { timestamp: true }\n                );\n              } else {\n                sheu.debug(`Final Prisma Args - Empty`, { timestamp: true });\n              }\n            }\n\n            return originalMethod.apply(modelTarget, args);\n          };\n        }\n\n        return originalMethod;\n      },\n    });\n  }\n\n  return originalProperty;\n}\n\nexport function getPrismaInstance() {\n  return new Proxy(getArkosConfig()?.prisma?.instance || {}, {\n    get: handlePrismaGet,\n  });\n}\n"]}
+{"version":3,"file":"prisma.helpers.js","sourceRoot":"","sources":["../../../../src/utils/helpers/prisma.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,IAAI,cAAc,GAAQ,IAAI,CAAC;AAEtC,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,cAAc,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC;IACpD,IAAI,CAAC,QAAQ;QACX,IAAI,CAAC,IAAI,CACP,qDAAqD,oBAAoB,EAAE,mEAAmE,EAC9I,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;IACJ,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAW,EAAE,IAAY,EAAE,QAAa;IACtE,MAAM,gBAAgB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAQ,CAAC;IAEtE,MAAM,OAAO,GACX,OAAO,gBAAgB,KAAK,QAAQ;QAClC,CAAC,CAAC,UAAU,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC;QACxC,CAAC,CAAC,KAAK,CAAC;IAEZ,IAAI,OAAO,IAAI,gBAAgB,EAAE,CAAC;QAChC,OAAO,IAAI,KAAK,CAAC,gBAAgB,EAAE;YACjC,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa;gBACxC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAChC,WAAW,EACX,UAAU,EACV,aAAa,CACd,CAAC;gBAEF,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;oBACzC,OAAO,UAAS,GAAG,IAAW;wBAC5B,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;wBAChC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;wBAE1D,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;4BACpB,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;4BAE1B,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gCACnD,IAAI,CAAC,KAAK,CACR,sBAAsB,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAC1D,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAC;4BACJ,CAAC;iCAAM,CAAC;gCACN,IAAI,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;4BAC/D,CAAC;wBACH,CAAC;wBAED,OAAO,cAAc,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;oBACjD,CAAC,CAAC;gBACJ,CAAC;gBAED,OAAO,cAAc,CAAC;YACxB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,QAAQ,IAAI,EAAE,EAAE;QACzD,GAAG,EAAE,eAAe;KACrB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { getArkosConfig } from \"./arkos-config.helpers\";\nimport sheu from \"../sheu\";\nimport { getUserFileExtension } from \"./fs.helpers\";\n\nexport let prismaInstance: any = null;\n\nexport function loadPrismaModule() {\n  const instance = getArkosConfig()?.prisma?.instance;\n  if (!instance)\n    sheu.warn(\n      `Prisma client instance not passed to arkos.config.${getUserFileExtension()}, see https://www.arkosjs.com/docs/core-concepts/prisma-orm/setup`,\n      { timestamp: true }\n    );\n  return instance;\n}\n\nexport function handlePrismaGet(target: any, prop: string, receiver: any) {\n  const originalProperty = (Reflect.get(target, prop, receiver)) as any;\n\n  const isModel =\n    typeof originalProperty === \"object\"\n      ? \"findMany\" in (originalProperty || {})\n      : false;\n\n  if (isModel && originalProperty) {\n    return new Proxy(originalProperty, {\n      get(modelTarget, methodName, modelReceiver) {\n        const originalMethod = Reflect.get(\n          modelTarget,\n          methodName,\n          modelReceiver\n        );\n\n        if (typeof originalMethod === \"function\") {\n          return function(...args: any[]) {\n            const config = getArkosConfig();\n            const debugLevel = config.debugging?.requests?.level || 0;\n\n            if (debugLevel >= 3) {\n              const queryArgs = args[0];\n\n              if (queryArgs && Object.keys(queryArgs).length > 0) {\n                sheu.debug(\n                  `Final Prisma Args\\n${JSON.stringify(queryArgs, null, 2)}`,\n                  { timestamp: true }\n                );\n              } else {\n                sheu.debug(`Final Prisma Args - Empty`, { timestamp: true });\n              }\n            }\n\n            return originalMethod.apply(modelTarget, args);\n          };\n        }\n\n        return originalMethod;\n      },\n    });\n  }\n\n  return originalProperty;\n}\n\nexport function getPrismaInstance() {\n  return new Proxy(getArkosConfig()?.prisma?.instance || {}, {\n    get: handlePrismaGet,\n  });\n}\n"]}

package/dist/types/components/arkos-gateway/arkos-gateway.d.ts

@@ -1,13 +1,15 @@
-import { ArkosGatewayConfig, ArkosGatewayErrorHandler, ArkosGatewayEventConfig, ArkosGatewayHandler, ArkosGatewayPipe, ArkosGatewayConnectionHandler, ArkosGatewayRegisterOptions } from "./types";
+import { ArkosGatewayConfig, ArkosGatewayErrorHandler, ArkosGatewayEventConfig, ArkosGatewayHandler, ArkosGatewayPipe, ArkosGatewayConnectionHandler, ArkosGatewayRegisterOptions, ArkosBroadcastOperator, ArkosEmitTarget } from "./types";
 import { Validator } from "../../types/validation/validator";
-import { Server } from "socket.io";
+import { BroadcastOperator, Namespace, Server } from "socket.io";
 export declare class IArkosGateway {
     private config;
     private events;
     private pipes;
     private gateways;
     private hooks;
+    private _nsp;
     constructor(config: ArkosGatewayConfig);
+    get nsp(): Omit<Namespace, keyof ArkosEmitTarget | keyof BroadcastOperator<any, any>> & ArkosBroadcastOperator;
     /**
      * Register a Socket.io connection-level middleware — runs before a socket
      * is accepted into this gateway's namespace. Also accepts a child

package/dist/types/components/arkos-gateway/socket-extensions.d.ts

@@ -1,9 +1,10 @@
-import { ArkosSocket } from "./types";
-import { BroadcastOperator } from "socket.io";
+import { ArkosEmitTarget, ArkosSocket, ArkosUserTarget } from "./types";
+import { Socket } from "socket.io";
 export declare class ArkosBroadcastOperatorImpl {
-    private readonly socket;
+    private readonly sockets;
     private readonly operator;
-    constructor(socket: ArkosSocket, operator: BroadcastOperator<any, any>);
+    constructor(sockets: Map<string, Socket>, operator: ArkosEmitTarget);
+    user(userId: string): ArkosUserTarget;
     /**
      * Returns all unique user IDs currently in the target room(s).
      * Uses the internal `arkos::user:` room convention to map sockets to users.

package/dist/types/components/arkos-gateway/types.d.ts

@@ -191,6 +191,22 @@ export interface ArkosBroadcastOperator<EmitEvents extends EventsMap = DefaultEv
      * @return a Promise that will be fulfilled when all clients have acknowledged the event
      */
     emitWithAck<Ev extends EventNamesWithError<EmitEvents>>(ev: Ev, ...args: AllButLast<EventParams<EmitEvents, Ev>>): Promise<FirstNonErrorArg<Last<EventParams<EmitEvents, Ev>>>>;
+    /**
+     * Targets all active socket connections of a user by their user ID.
+     * Uses the internal `arkos::user:{userId}` room convention.
+     *
+     * Supports emit, management, and exclusion operations across all of the
+     * user's active connections.
+     *
+     * @example
+     * socket.user(userId).emit("notification", data)
+     * socket.user(userId).except({ user: otherUserId }).emit("sync", data)
+     * const sockets = await socket.user(userId).fetchSockets()
+     * const online = await socket.user(userId).isOnline()
+     *
+     * @since 1.7.0-canary.29
+     */
+    user(userId: string): ArkosUserTarget;
     /**
      * Returns all unique user IDs currently in the target room(s).
      *
@@ -360,5 +376,75 @@ export interface ArkosGatewayStore {
      */
     setIfNotExists(key: string, ttl: number): Promise<boolean>;
 }
+/**
+ * Minimal broadcast/emit contract that {@link ArkosBroadcastOperatorImpl} wraps.
+ * Deliberately narrower than socket.io's `BroadcastOperator` — only the methods
+ * Arkos actually calls, so both a `BroadcastOperator` (from `socket.to()`) and a
+ * raw `Namespace` (from `gateway.nsp`) satisfy it structurally.
+ *
+ * @since 1.7.1-canary.3
+ */
+export interface ArkosEmitTarget<EmitEvents extends EventsMap = DefaultEventsMap> {
+    /**
+     * Emits an event to the target. `_meta` (`mid` + `timestamp`) is injected automatically.
+     *
+     * @example
+     * socket.to("room-101").emit("message", { text: "hello" })
+     * socket.broadcast.emit("announcement", data)
+     */
+    emit(event: string, ...args: any[]): boolean;
+    /**
+     * Emits an event and waits for an acknowledgement from all matched clients.
+     * `_meta` is injected automatically.
+     *
+     * Optional — not every target supports ack collection directly (e.g. a raw
+     * `Namespace` requires `.timeout(ms)` first). Throws at runtime if called on
+     * a target that doesn't implement it natively.
+     *
+     * @example
+     * const responses = await socket.to("room-101").timeout(3000).emitWithAck("confirm", data)
+     */
+    emitWithAck?(event: string, ...args: any[]): Promise<any>;
+    /**
+     * Excludes sockets from the broadcast.
+     * Accepts a room name, socket ID, or array of rooms/IDs.
+     * For `{ user }` exclusion, see {@link ArkosBroadcastOperatorImpl.except}.
+     *
+     * @example
+     * socket.to("room-101").except("room-102").emit("foo", data)
+     */
+    except(room: string | string[]): ArkosEmitTarget<EmitEvents>;
+    /**
+     * Sets the compress flag for the next emission.
+     *
+     * @example
+     * socket.broadcast.compress(false).emit("ping", data)
+     */
+    compress(value: boolean): ArkosEmitTarget<EmitEvents>;
+    /**
+     * Sets a timeout in milliseconds for `emitWithAck`.
+     * Rejects the promise if no client acknowledges within the given delay.
+     *
+     * @example
+     * socket.to("room-101").timeout(3000).emitWithAck("confirm", data)
+     */
+    timeout(ms: number): ArkosEmitTarget;
+    /**
+     * Returns all sockets currently matched by this target.
+     *
+     * @example
+     * const sockets = await socket.to("room-101").fetchSockets()
+     */
+    fetchSockets(): Promise<any[]>;
+    to(room: string | string[]): ArkosEmitTarget;
+    /**
+     * Sets the volatile flag — the event may be dropped if the client is not ready.
+     * Useful for high-frequency non-critical events like cursor positions or typing indicators.
+     *
+     * @example
+     * socket.to("room-101").volatile.emit("cursor", position)
+     */
+    readonly volatile: ArkosEmitTarget<EmitEvents>;
+}
 export declare class ArkosGatewayController {
 }

package/dist/types/modules/email/email.service.d.ts

@@ -21,6 +21,8 @@ export type SMTPConnectionOptions = {
     secure?: boolean;
     auth?: SMTPAuthOptions;
     name?: string;
+    user?: string;
+    pass?: string;
 };
 /**
  * A service class to handle email-related tasks, including sending emails.

package/dist/types/utils/dotenv.helpers.d.ts

@@ -1,3 +1,4 @@
+export declare let lastLoadedEnvFiles: string[];
 /**
  * Loads and expands environment variables in a prioritized order
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkos",
-  "version": "2.0.0-next.26",
+  "version": "2.0.0-next.28",
   "type": "module",
   "description": "The Express & Prisma RESTful Framework",
   "main": "dist/esm/exports/index.js",
@@ -207,7 +207,7 @@
     "uuidv7": "^1.2.1"
   },
   "peerDependencies": {
-    "@prisma/client": "7.9.0",
+    "@prisma/client": "7.9.1",
     "@scalar/api-reference": "1.63.0",
     "@scalar/express-api-reference": "0.10.11",
     "bcryptjs": "3.0.3",