ztechno_core 0.0.110 → 0.0.112

package/lib/typings/crypto_types.d.ts

@@ -1,4 +0,0 @@
-export type HashStruct = {
-  iv: string;
-  encryptedData: string;
-};

package/lib/typings/crypto_types.js

@@ -1,2 +0,0 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', { value: true });

package/lib/typings/index.d.ts

@@ -1,4 +0,0 @@
-export * from './crypto_types';
-export * from './mail_types';
-export * from './translate_types';
-export * from './user_types';

package/lib/typings/index.js

@@ -1,36 +0,0 @@
-'use strict';
-var __createBinding =
-  (this && this.__createBinding) ||
-  (Object.create
-    ? function (o, m, k, k2) {
-        if (k2 === undefined) k2 = k;
-        var desc = Object.getOwnPropertyDescriptor(m, k);
-        if (!desc || ('get' in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-          desc = {
-            enumerable: true,
-            get: function () {
-              return m[k];
-            },
-          };
-        }
-        Object.defineProperty(o, k2, desc);
-      }
-    : function (o, m, k, k2) {
-        if (k2 === undefined) k2 = k;
-        o[k2] = m[k];
-      });
-var __exportStar =
-  (this && this.__exportStar) ||
-  function (m, exports) {
-    for (var p in m)
-      if (p !== 'default' && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-  };
-Object.defineProperty(exports, '__esModule', { value: true });
-// Crypto types
-__exportStar(require('./crypto_types'), exports);
-// Mail types
-__exportStar(require('./mail_types'), exports);
-// Translate types
-__exportStar(require('./translate_types'), exports);
-// User types
-__exportStar(require('./user_types'), exports);

package/lib/typings/mail_types.d.ts

@@ -1,95 +0,0 @@
-import SMTPTransport from 'nodemailer/lib/smtp-transport';
-import { Attachment } from 'nodemailer/lib/mailer';
-import { ZSQLService } from '../sql_service';
-export type MailAttachment = Attachment;
-interface OptionalOptions {
-  cacheDir?:
-    | string
-    | false
-    | undefined /** optional location for cached messages. If not set then caching is not used. */;
-  cacheTreshold?:
-    | number
-    | undefined /** optional size in bytes, if message is larger than this treshold it gets cached to disk (assuming cacheDir is set and writable). Defaults to 131072 (128 kB). */;
-  hashAlgo?: string | undefined /** optional algorithm for the body hash, defaults to ‘sha256’ */;
-  headerFieldNames?:
-    | string
-    | undefined /** an optional colon separated list of header keys to sign (eg. message-id:date:from:to...') */;
-  skipFields?:
-    | string
-    | undefined /** optional colon separated list of header keys not to sign. This is useful if you want to sign all the relevant keys but your provider changes some values, ie Message-ID and Date. In this case you should use 'message-id:date' to prevent signing these values. */;
-}
-interface SingleDKIMKeyOptions extends OptionalOptions {
-  domainName: string /** is the domain name to use in the signature */;
-  keySelector: string /** is the DKIM key selector */;
-  privateKey:
-    | string
-    | {
-        key: string;
-        passphrase: string;
-      } /** is the private key for the selector in PEM format */;
-}
-export type MailResponse = SMTPTransport.SentMessageInfo;
-export type MailServiceOptions = {
-  auth: {
-    user: string;
-    pass: string;
-  };
-  mailSender: string;
-  dkim?: SingleDKIMKeyOptions;
-  sqlService: ZSQLService;
-  hashSalt?: string;
-  dirTemplate?: string;
-  baseInject?: {
-    logoSrc?: string;
-    baseUrl?: string;
-    title: string;
-    content: string;
-  };
-};
-export type MailOptionsBase = {
-  recipient: string;
-  subject: string;
-  from?: string;
-  priority?: 'high' | 'normal' | 'low';
-  dkim?: SingleDKIMKeyOptions;
-  attachments?: MailAttachment[];
-};
-export type MailOptionsText = MailOptionsBase & {
-  body: string;
-};
-export type MailOptionsHtml = MailOptionsBase & {
-  html: string;
-};
-export type MailOptions = MailOptionsBase & {
-  body?: string;
-  html?: string;
-};
-export type ZMailSendOptTemplate = MailOptionsBase & {
-  template: 'C:/example/template.html' | string;
-  inject: {
-    title: string;
-    content: string;
-  } & {
-    [key: string]: string | number;
-  };
-};
-export type ZMailSendOptAll = MailOptionsBase & {
-  body: string;
-  html: string;
-  template: 'C:/example/template.html' | string;
-  inject: {
-    title: string;
-    content: string;
-  } & {
-    [key: string]: string | number;
-  };
-};
-export type ZMailBlacklist = {
-  email: string;
-  hash?: string;
-  is_blacklisted: 0 | 1 | boolean;
-  updated_at: string;
-  created_at: string;
-};
-export type ZMailBlacklistSearch = Pick<ZMailBlacklist, 'email' | 'is_blacklisted'>;
-export {};

package/lib/typings/mail_types.js

@@ -1,2 +0,0 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', { value: true });

package/lib/typings/translate_types.d.ts

@@ -1,69 +0,0 @@
-import { ZSQLService } from '../sql_service';
-export type Dom = {} & Node;
-export type Node = {
-  getAttribute: (attr: string) => string;
-  getElementsByTagName: (tag: string) => Node[];
-  getElementsByClassName: (cls: string) => Node[];
-  getElementById: (id: string) => Node;
-  getElementsByName: (name: string) => Node[];
-  nodeType: string;
-  nodeName: string;
-  childNodes: Node[];
-  firstChild: Node;
-  lastChild: Node;
-  parentNode: Node;
-  attributes: any[];
-  innerHTML: string;
-  outerHTML: string;
-  textContent: string;
-  text: string;
-};
-export type ZNodeText = {
-  text: string;
-} & Node;
-export type TranslateData = {
-  value: string;
-  meta?: {
-    prefix: string;
-    suffix: string;
-  };
-};
-export type dbTranslationRow = {
-  lang: string;
-  key: string;
-  value: string;
-};
-export type ATranslateLang = {
-  lang: string;
-  text: string;
-};
-export type TranslateServiceOptions = {
-  sqlService: ZSQLService;
-  googleApiKey: string;
-  languages?: ATranslateLang[];
-  defaultLang?: string;
-  sourceLang?: string;
-  surpressErrors?: boolean;
-  log?: (data: any, context: any) => any;
-  verbose?: (data: any, context: any) => any;
-  maxRetries?: number;
-  retryDelay?: number;
-  fallbackText?: string;
-};
-export declare class TranslateError extends Error {
-  code: string;
-  context?: any;
-  constructor(message: string, code: string, context?: any);
-}
-export declare class HtmlEntityError extends TranslateError {
-  constructor(code: string, text: string);
-}
-export declare class ApiTranslationError extends TranslateError {
-  constructor(originalError: any, text: string, lang: string);
-}
-export declare class DatabaseError extends TranslateError {
-  constructor(originalError: any, operation: string);
-}
-export declare class ValidationError extends TranslateError {
-  constructor(field: string, value: any);
-}

package/lib/typings/translate_types.js

@@ -1,46 +0,0 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', { value: true });
-exports.ValidationError =
-  exports.DatabaseError =
-  exports.ApiTranslationError =
-  exports.HtmlEntityError =
-  exports.TranslateError =
-    void 0;
-// Custom error types for better error handling
-class TranslateError extends Error {
-  constructor(message, code, context) {
-    super(message);
-    this.code = code;
-    this.context = context;
-    this.name = 'TranslateError';
-  }
-}
-exports.TranslateError = TranslateError;
-class HtmlEntityError extends TranslateError {
-  constructor(code, text) {
-    super(`Cannot recognize character code="${code}" for text="${text}"`, 'HTML_ENTITY_ERROR', { code, text });
-  }
-}
-exports.HtmlEntityError = HtmlEntityError;
-class ApiTranslationError extends TranslateError {
-  constructor(originalError, text, lang) {
-    super(`Translation API failed for text="${text}" to language="${lang}"`, 'API_TRANSLATION_ERROR', {
-      originalError,
-      text,
-      lang,
-    });
-  }
-}
-exports.ApiTranslationError = ApiTranslationError;
-class DatabaseError extends TranslateError {
-  constructor(originalError, operation) {
-    super(`Database operation failed: ${operation}`, 'DATABASE_ERROR', { originalError, operation });
-  }
-}
-exports.DatabaseError = DatabaseError;
-class ValidationError extends TranslateError {
-  constructor(field, value) {
-    super(`Invalid ${field}: ${value}`, 'VALIDATION_ERROR', { field, value });
-  }
-}
-exports.ValidationError = ValidationError;

package/lib/typings/user_types.d.ts

@@ -1,41 +0,0 @@
-export type ZUserCore = {
-  user_id: number;
-  email: string;
-  session: string;
-  role: string | null;
-  admin: 0 | 1;
-  updated_at: any;
-  created_at: any;
-};
-export type ZUser = ZUserCore;
-export interface ZUserExtended extends ZUserCore {
-  username?: string;
-  first_name?: string;
-  last_name?: string;
-  avatar_url?: string;
-  bio?: string;
-  is_active?: 0 | 1;
-  email_verified?: 0 | 1;
-  last_login?: any;
-}
-export type ZRequiredUserColumns = {
-  email: string;
-  role: string | null;
-  pass: string;
-  admin: 0 | 1;
-};
-export type ZRequiredUserColumnsExtended<T = {}> = ZRequiredUserColumns & Partial<T>;
-export type ZUserCredentials = {
-  email: string;
-  pass: string;
-};
-export type ZUserSession = {
-  session: string;
-};
-export type ZUserTableConfig = {
-  tableName?: string;
-  customColumns?: {
-    [columnName: string]: string;
-  };
-  customIndexes?: string[];
-};

package/lib/typings/user_types.js

@@ -1,2 +0,0 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', { value: true });

package/lib/user_service.d.ts

@@ -1,80 +0,0 @@
-import { ZSQLService } from './sql_service';
-import { ZRequiredUserColumns, ZUser, ZUserCore, ZUserSession, ZUserCredentials, ZUserTableConfig } from './typings';
-/**
- * Generic User Service that can be extended with custom user fields
- * @template TUser - The user type (defaults to ZUser for backward compatibility)
- * @template TUserCreate - The user creation type (defaults to ZRequiredUserColumns)
- */
-export declare class ZUserService<
-  TUser extends ZUserCore = ZUser,
-  TUserCreate extends ZRequiredUserColumns = ZRequiredUserColumns,
-> {
-  protected tableName: string;
-  protected sqlService: ZSQLService;
-  protected tableConfig: ZUserTableConfig;
-  private salt;
-  /**
-   * Creates a new ZUserService instance
-   * @param options - Configuration options including SQL service and optional table configuration
-   */
-  constructor({ sqlService, tableConfig }: { sqlService: ZSQLService; tableConfig?: ZUserTableConfig });
-  /**
-   * Gets the base table columns definition
-   * @returns SQL column definitions for core user fields
-   * @protected
-   */
-  protected getBaseTableColumns(): string;
-  /**
-   * Gets custom table columns if defined
-   * @returns SQL column definitions for custom fields
-   * @protected
-   */
-  protected getCustomTableColumns(): string;
-  /**
-   * Gets base table indexes
-   * @returns SQL index definitions for core fields
-   * @protected
-   */
-  protected getBaseTableIndexes(): string;
-  /**
-   * Gets custom table indexes if defined
-   * @returns SQL index definitions for custom fields
-   * @protected
-   */
-  protected getCustomTableIndexes(): string;
-  protected checkTableExists(): Promise<boolean>;
-  checkTableHasAdmin(): Promise<boolean>;
-  protected createTable(): Promise<void>;
-  ensureTableExists(): Promise<void>;
-  /**
-   * Registers a new user with extensible data
-   * @param userData - User data including core fields and any custom fields
-   * @returns Promise resolving to session information
-   */
-  register(userData: TUserCreate): Promise<{
-    session: string;
-  }>;
-  /**
-   * Gets all available columns for SELECT queries
-   * @returns Comma-separated list of column names
-   * @protected
-   */
-  protected getSelectColumns(): string;
-  find(
-    opt:
-      | {
-          email: string;
-        }
-      | {
-          user_id: number;
-        },
-  ): Promise<TUser | undefined>;
-  auth(opt: ZUserSession | ZUserCredentials): Promise<{
-    user?: TUser;
-    session?: string;
-    authenticated: boolean;
-  }>;
-  fetch(opt?: { limit?: number }): Promise<TUser[]>;
-  private genSession;
-  private hashPass;
-}

package/lib/user_service.js

@@ -1,216 +0,0 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', { value: true });
-exports.ZUserService = void 0;
-const crypto_service_1 = require('./crypto_service');
-/**
- * Generic User Service that can be extended with custom user fields
- * @template TUser - The user type (defaults to ZUser for backward compatibility)
- * @template TUserCreate - The user creation type (defaults to ZRequiredUserColumns)
- */
-class ZUserService {
-  /**
-   * Creates a new ZUserService instance
-   * @param options - Configuration options including SQL service and optional table configuration
-   */
-  constructor({ sqlService, tableConfig }) {
-    this.sqlService = sqlService;
-    this.tableConfig = tableConfig || {};
-    this.tableName = this.tableConfig.tableName || 'users';
-    this.salt = sqlService.database;
-  }
-  /**
-   * Gets the base table columns definition
-   * @returns SQL column definitions for core user fields
-   * @protected
-   */
-  getBaseTableColumns() {
-    return `
-      \`user_id\` int(10) unsigned NOT NULL AUTO_INCREMENT,
-      \`email\` varchar(255) NOT NULL,
-      \`role\` varchar(64) DEFAULT NULL,
-      \`pass\` varchar(512) NOT NULL,
-      \`session\` varchar(512) NOT NULL,
-      \`admin\` tinyint(1) NOT NULL DEFAULT 0,
-      \`updated_at\` datetime NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
-      \`created_at\` datetime NOT NULL DEFAULT current_timestamp()
-    `;
-  }
-  /**
-   * Gets custom table columns if defined
-   * @returns SQL column definitions for custom fields
-   * @protected
-   */
-  getCustomTableColumns() {
-    if (!this.tableConfig.customColumns) return '';
-    return Object.entries(this.tableConfig.customColumns)
-      .map(([columnName, definition]) => `\`${columnName}\` ${definition}`)
-      .join(',\n      ');
-  }
-  /**
-   * Gets base table indexes
-   * @returns SQL index definitions for core fields
-   * @protected
-   */
-  getBaseTableIndexes() {
-    return `
-      PRIMARY KEY (\`user_id\`),
-      UNIQUE KEY \`email_UNIQUE\` (\`email\`),
-      KEY \`email\` (\`email\`),
-      KEY \`role\` (\`role\`),
-      KEY \`admin\` (\`admin\`),
-      KEY \`created_at\` (\`created_at\`),
-      KEY \`updated_at\` (\`updated_at\`),
-      KEY \`session\` (\`session\`)
-    `;
-  }
-  /**
-   * Gets custom table indexes if defined
-   * @returns SQL index definitions for custom fields
-   * @protected
-   */
-  getCustomTableIndexes() {
-    if (!this.tableConfig.customIndexes) return '';
-    return this.tableConfig.customIndexes
-      .map((index) => index.trim())
-      .filter((index) => index.length > 0)
-      .join(',\n      ');
-  }
-  async checkTableExists() {
-    const res = await this.sqlService.query(`
-      SELECT ENGINE, VERSION, CREATE_TIME FROM information_schema.tables
-      WHERE table_schema = '${this.sqlService.database}' AND table_name = '${this.tableName}'
-      LIMIT 1
-    `);
-    return res.length > 0;
-  }
-  async checkTableHasAdmin() {
-    const res = await this.sqlService.query(`
-      SELECT user_id FROM \`${this.tableName}\` WHERE admin=1
-    `);
-    return res.length > 0;
-  }
-  async createTable() {
-    const baseColumns = this.getBaseTableColumns();
-    const customColumns = this.getCustomTableColumns();
-    const baseIndexes = this.getBaseTableIndexes();
-    const customIndexes = this.getCustomTableIndexes();
-    const allColumns = customColumns ? `${baseColumns},\n      ${customColumns}` : baseColumns;
-    const allIndexes = customIndexes ? `${baseIndexes},\n      ${customIndexes}` : baseIndexes;
-    await this.sqlService.query(`
-      CREATE TABLE \`${this.tableName}\` (
-        ${allColumns},
-        ${allIndexes}
-      ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
-    `);
-  }
-  async ensureTableExists() {
-    const exists = await this.checkTableExists();
-    if (!exists) {
-      await this.createTable();
-    }
-  }
-  /**
-   * Registers a new user with extensible data
-   * @param userData - User data including core fields and any custom fields
-   * @returns Promise resolving to session information
-   */
-  async register(userData) {
-    const session = this.genSession({ email: userData.email, pass: userData.pass });
-    // Build dynamic SQL for insertion
-    const coreFields = ['email', 'pass', 'session', 'role', 'admin'];
-    const customFields = Object.keys(userData).filter((key) => !coreFields.includes(key) && key !== 'pass');
-    const allFields = [...coreFields, ...customFields];
-    const placeholders = allFields.map(() => '?').join(', ');
-    const fieldNames = allFields.map((field) => `\`${field}\``).join(', ');
-    const values = allFields.map((field) => {
-      if (field === 'pass') return this.hashPass({ email: userData.email, pass: userData.pass });
-      if (field === 'session') return session;
-      return userData[field];
-    });
-    await this.sqlService.query(
-      `
-      INSERT INTO \`${this.tableName}\` (${fieldNames})
-      VALUES (${placeholders})
-    `,
-      values,
-    );
-    return { session };
-  }
-  /**
-   * Gets all available columns for SELECT queries
-   * @returns Comma-separated list of column names
-   * @protected
-   */
-  getSelectColumns() {
-    const baseColumns = ['user_id', 'email', 'session', 'role', 'admin', 'updated_at', 'created_at'];
-    const customColumns = this.tableConfig.customColumns ? Object.keys(this.tableConfig.customColumns) : [];
-    return [...baseColumns, ...customColumns].map((col) => `\`${col}\``).join(', ');
-  }
-  async find(opt) {
-    const selectColumns = this.getSelectColumns();
-    if (opt.email !== undefined) {
-      const rows = await this.sqlService.fetch({
-        Query: /*SQL*/ `
-          SELECT ${selectColumns} FROM \`${this.tableName}\`
-          WHERE email=:email
-        `,
-        Params: { email: opt.email },
-      });
-      return rows[0];
-    } else if (opt.user_id !== undefined) {
-      const rows = await this.sqlService.fetch({
-        Query: /*SQL*/ `
-          SELECT ${selectColumns} FROM \`${this.tableName}\`
-          WHERE user_id=:user_id
-        `,
-        Params: { user_id: opt.user_id },
-      });
-      return rows[0];
-    } else {
-      throw new Error(`Unexpected Input for ZUserService.find(${JSON.stringify(opt)})`);
-    }
-  }
-  async auth(opt) {
-    if (!opt.session && !opt.email && !opt.pass) {
-      return { authenticated: false };
-    }
-    const selectColumns = this.getSelectColumns();
-    const res = await (opt.session
-      ? this.sqlService.fetch({
-          Query: /*SQL*/ `
-        SELECT ${selectColumns} FROM \`${this.tableName}\` WHERE session=?
-      `,
-          Params: [opt.session],
-        })
-      : this.sqlService.fetch({
-          Query: /*SQL*/ `
-        SELECT ${selectColumns} FROM \`${this.tableName}\` WHERE email=? AND pass=?
-      `,
-          Params: [opt.email, this.hashPass(opt)],
-        }));
-    return res.length === 0 ? { authenticated: false } : { user: res[0], session: res[0].session, authenticated: true };
-  }
-  async fetch(opt) {
-    const selectColumns = this.getSelectColumns();
-    const limit = opt?.limit || 100;
-    const rows = await this.sqlService.fetch(
-      `
-      SELECT ${selectColumns} FROM \`${this.tableName}\`
-      ORDER BY created_at DESC
-      LIMIT ?
-    `,
-      [limit],
-    );
-    return rows;
-  }
-  genSession({ email }) {
-    const salt = this.salt;
-    const data = email + Date.now() * Math.random();
-    return crypto_service_1.ZCryptoService.hash('sha256', data, { saltMode: 'simple', salt });
-  }
-  hashPass({ email, pass }) {
-    const salt = email + this.salt;
-    return crypto_service_1.ZCryptoService.hash('sha256', pass, { saltMode: 'simple', salt });
-  }
-}
-exports.ZUserService = ZUserService;