@lssm/lib.jobs 0.0.0-canary-20251206160926

package/dist/scheduler/index.d.ts

@@ -0,0 +1,92 @@
+import { EnqueueOptions, JobQueue } from "../queue/types.js";
+
+//#region src/scheduler/index.d.ts
+
+/**
+ * Scheduled job configuration.
+ */
+interface ScheduledJobConfig {
+  /** Unique name for the schedule */
+  name: string;
+  /** Cron expression (e.g., '0 0 * * *' for daily at midnight) */
+  cronExpression: string;
+  /** Job type to enqueue */
+  jobType: string;
+  /** Job payload (can be a function for dynamic payloads) */
+  payload?: unknown | (() => unknown | Promise<unknown>);
+  /** Enqueue options */
+  options?: EnqueueOptions;
+  /** Timezone for cron evaluation (default: UTC) */
+  timezone?: string;
+  /** Whether the schedule is enabled */
+  enabled?: boolean;
+  /** Description */
+  description?: string;
+}
+/**
+ * Active scheduled job with next run time.
+ */
+interface ActiveSchedule extends ScheduledJobConfig {
+  nextRun: Date | null;
+  lastRun: Date | null;
+}
+/**
+ * Job scheduler for recurring jobs.
+ */
+declare class JobScheduler {
+  private readonly queue;
+  private readonly schedules;
+  private timer?;
+  private readonly checkIntervalMs;
+  constructor(queue: JobQueue, options?: {
+    checkIntervalMs?: number;
+  });
+  /**
+   * Add a scheduled job.
+   */
+  schedule(config: ScheduledJobConfig): void;
+  /**
+   * Remove a scheduled job.
+   */
+  unschedule(name: string): boolean;
+  /**
+   * Enable a scheduled job.
+   */
+  enable(name: string): boolean;
+  /**
+   * Disable a scheduled job.
+   */
+  disable(name: string): boolean;
+  /**
+   * Get all schedules.
+   */
+  getSchedules(): ActiveSchedule[];
+  /**
+   * Get a specific schedule.
+   */
+  getSchedule(name: string): ActiveSchedule | undefined;
+  /**
+   * Start the scheduler.
+   */
+  start(): void;
+  /**
+   * Stop the scheduler.
+   */
+  stop(): void;
+  /**
+   * Check and enqueue due schedules.
+   */
+  private checkSchedules;
+}
+/**
+ * Create a job scheduler instance.
+ */
+declare function createScheduler(queue: JobQueue, options?: {
+  checkIntervalMs?: number;
+}): JobScheduler;
+/**
+ * Helper to define a scheduled job configuration.
+ */
+declare function defineSchedule(config: ScheduledJobConfig): ScheduledJobConfig;
+//#endregion
+export { ActiveSchedule, JobScheduler, ScheduledJobConfig, createScheduler, defineSchedule };

package/dist/scheduler/index.js

@@ -0,0 +1 @@
+function e(e,t=new Date){try{let n=e.trim().split(/\s+/);if(n.length!==5)return console.warn(`Invalid cron expression: ${e}`),null;let r=n[0],i=n[1],a=n[2],o=n[3],s=new Date(t);if(s.setSeconds(0),s.setMilliseconds(0),r&&i&&r!==`*`&&i!==`*`&&a===`*`&&o===`*`){let e=Number.parseInt(r,10),n=Number.parseInt(i,10);return s.setHours(n,e,0,0),s<=t&&s.setDate(s.getDate()+1),s}return s.setMinutes(s.getMinutes()+1),s}catch{return null}}var t=class{schedules=new Map;timer;checkIntervalMs;constructor(e,t={}){this.queue=e,this.checkIntervalMs=t.checkIntervalMs??6e4}schedule(t){let n=t.enabled===!1?null:e(t.cronExpression);this.schedules.set(t.name,{...t,enabled:t.enabled??!0,nextRun:n,lastRun:null})}unschedule(e){return this.schedules.delete(e)}enable(t){let n=this.schedules.get(t);return n?(n.enabled=!0,n.nextRun=e(n.cronExpression),!0):!1}disable(e){let t=this.schedules.get(e);return t?(t.enabled=!1,t.nextRun=null,!0):!1}getSchedules(){return Array.from(this.schedules.values())}getSchedule(e){return this.schedules.get(e)}start(){this.timer||=(this.checkSchedules(),setInterval(()=>{this.checkSchedules()},this.checkIntervalMs))}stop(){this.timer&&=(clearInterval(this.timer),void 0)}async checkSchedules(){let t=new Date;for(let n of this.schedules.values())if(!(!n.enabled||!n.nextRun)&&n.nextRun<=t)try{let r=typeof n.payload==`function`?await n.payload():n.payload;await this.queue.enqueue(n.jobType,r,n.options),n.lastRun=t,n.nextRun=e(n.cronExpression,t)}catch(e){console.error(`Failed to enqueue scheduled job ${n.name}:`,e)}}};function n(e,n){return new t(e,n)}function r(e){return e}export{t as JobScheduler,n as createScheduler,r as defineSchedule};

package/dist/schema/dist/EnumType.js

@@ -0,0 +1 @@
+import{z as e}from"zod";import"graphql";

package/dist/schema/dist/FieldType.js

@@ -0,0 +1 @@
+import{z as e}from"zod";import{GraphQLScalarType as t}from"graphql";var n=class extends t{zodSchema;jsonSchemaDef;constructor(e){super(e),this.zodSchema=e.zod,this.jsonSchemaDef=e.jsonSchema}getZod(){return this.zodSchema}getPothos(){return this}getJson(){return typeof this.jsonSchemaDef==`function`?this.jsonSchemaDef():this.jsonSchemaDef}getJsonSchemaDef(){return this.jsonSchemaDef}getJsonSchema(){let e=t=>{let n=typeof t==`function`?t():t;if(Array.isArray(n))return n.map(t=>e(t));if(n&&typeof n==`object`){let t={};for(let[r,i]of Object.entries(n))t[r]=e(i);return t}return n};return e(this.getJson())}};export{n};

package/dist/schema/dist/ScalarTypeEnum.js

@@ -0,0 +1 @@
+import{n as e}from"./FieldType.js";import{z as t}from"zod";import{Kind as n}from"graphql";const r=/^[A-Za-z]{2}(?:-[A-Za-z0-9]{2,8})*$/,i=/^(?:UTC|[A-Za-z_]+\/[A-Za-z_]+)$/,a=/^[+]?\d[\d\s().-]{3,}$/,o=/^[A-Z]{3}$/,s=/^[A-Z]{2}$/,c=-180,l={String_unsecure:()=>new e({name:`String_unsecure`,description:`Unvalidated string scalar`,zod:t.string(),parseValue:e=>t.string().parse(e),serialize:e=>String(e),parseLiteral:e=>{if(e.kind!==n.STRING)throw TypeError(`Invalid literal`);return e.value},jsonSchema:{type:`string`}}),Int_unsecure:()=>new e({name:`Int_unsecure`,description:`Unvalidated integer scalar`,zod:t.number().int(),parseValue:e=>{let n=typeof e==`number`?e:Number(e);return t.number().int().parse(n)},serialize:e=>Math.trunc(typeof e==`number`?e:Number(e)),parseLiteral:e=>{if(e.kind!==n.INT)throw TypeError(`Invalid literal`);return Number(e.value)},jsonSchema:{type:`integer`}}),Float_unsecure:()=>new e({name:`Float_unsecure`,description:`Unvalidated float scalar`,zod:t.number(),parseValue:e=>{let n=typeof e==`number`?e:Number(e);return t.number().parse(n)},serialize:e=>Number(e),parseLiteral:e=>{if(e.kind!==n.FLOAT&&e.kind!==n.INT)throw TypeError(`Invalid literal`);return Number(e.value)},jsonSchema:{type:`number`}}),Boolean:()=>new e({name:`Boolean`,description:`Unvalidated boolean scalar`,zod:t.boolean(),parseValue:e=>t.coerce.boolean().parse(e),serialize:e=>!!e,parseLiteral:e=>{if(e.kind!==n.BOOLEAN)throw TypeError(`Invalid literal`);return e.value},jsonSchema:{type:`boolean`}}),ID:()=>new e({name:`ID`,description:`Unvalidated id scalar`,zod:t.string(),parseValue:e=>t.string().parse(e),serialize:e=>String(e),parseLiteral:e=>{if(e.kind!==n.STRING)throw TypeError(`Invalid literal`);return e.value},jsonSchema:{type:`string`}}),JSON:()=>new e({name:`JSON`,zod:t.any(),parseValue:e=>e,serialize:e=>e,jsonSchema:{}}),JSONObject:()=>new e({name:`JSONObject`,zod:t.record(t.string(),t.any()),parseValue:e=>t.record(t.string(),t.any()).parse(e),serialize:e=>e??{},jsonSchema:{type:`object`}}),Date:()=>new e({name:`Date`,zod:t.date(),parseValue:e=>e instanceof Date?e:new Date(String(e)),serialize:e=>e instanceof Date?e.toISOString().split(`T`)[0]:String(e),jsonSchema:{type:`string`,format:`date`}}),DateTime:()=>new e({name:`DateTime`,zod:t.date(),parseValue:e=>e instanceof Date?e:new Date(String(e)),serialize:e=>e instanceof Date?e.toISOString():String(e),jsonSchema:{type:`string`,format:`date-time`}}),Time:()=>new e({name:`Time`,zod:t.string().regex(/^\d{2}:\d{2}(:\d{2})?$/),parseValue:e=>t.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:`^\\d{2}:\\d{2}(:\\d{2})?$`}}),EmailAddress:()=>new e({name:`EmailAddress`,zod:t.string().email(),parseValue:e=>t.string().email().parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,format:`email`}}),URL:()=>new e({name:`URL`,zod:t.string().url(),parseValue:e=>t.string().url().parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,format:`uri`}}),PhoneNumber:()=>new e({name:`PhoneNumber`,zod:t.string().regex(a),parseValue:e=>t.string().regex(a).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:a.source}}),NonEmptyString:()=>new e({name:`NonEmptyString`,zod:t.string().min(1),parseValue:e=>t.string().min(1).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,minLength:1}}),Locale:()=>new e({name:`Locale`,zod:t.string().regex(r),parseValue:e=>t.string().regex(r).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:r.source}}),TimeZone:()=>new e({name:`TimeZone`,zod:t.string().regex(i),parseValue:e=>t.string().regex(i).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:i.source}}),Latitude:()=>new e({name:`Latitude`,zod:t.number().min(-90).max(90),parseValue:e=>t.coerce.number().min(-90).max(90).parse(e),serialize:e=>Number(e),jsonSchema:{type:`number`,minimum:-90,maximum:90}}),Longitude:()=>new e({name:`Longitude`,zod:t.number().min(c).max(180),parseValue:e=>t.coerce.number().min(c).max(180).parse(e),serialize:e=>Number(e),jsonSchema:{type:`number`,minimum:c,maximum:180}}),Currency:()=>new e({name:`Currency`,zod:t.string().regex(o),parseValue:e=>t.string().regex(o).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:o.source}}),CountryCode:()=>new e({name:`CountryCode`,zod:t.string().regex(s),parseValue:e=>t.string().regex(s).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:s.source}})};export{l};

package/dist/schema/dist/SchemaModel.js

@@ -0,0 +1 @@
+import"./EnumType.js";import"./FieldType.js";import{z as e}from"zod";var t=class{constructor(e){this.config=e}getZod(){let t=Object.entries(this.config.fields).reduce((t,[n,r])=>{let i=r.type.getZod(),a=r.isArray?e.array(i):i;return t[n]=r.isOptional?a.optional():a,t},{});return e.object(t)}getPothosInput(){return this.config.name}};const n=e=>new t(e);export{n,t};

package/dist/schema/dist/entity/defineEntity.js

@@ -0,0 +1 @@
+import{z as e}from"zod";function t(e){return e}function n(e){return e}const r={string(e){return{kind:`scalar`,type:`String`,...e}},int(e){return{kind:`scalar`,type:`Int`,...e}},float(e){return{kind:`scalar`,type:`Float`,...e}},boolean(e){return{kind:`scalar`,type:`Boolean`,...e}},dateTime(e){return{kind:`scalar`,type:`DateTime`,...e}},json(e){return{kind:`scalar`,type:`Json`,...e}},bigInt(e){return{kind:`scalar`,type:`BigInt`,...e}},decimal(e){return{kind:`scalar`,type:`Decimal`,...e}},bytes(e){return{kind:`scalar`,type:`Bytes`,...e}},id(e){return{kind:`scalar`,type:`String`,isId:!0,default:`cuid()`,...e}},uuid(e){return{kind:`scalar`,type:`String`,isId:!0,default:`uuid()`,...e}},autoIncrement(e){return{kind:`scalar`,type:`Int`,isId:!0,default:`autoincrement()`,...e}},createdAt(e){return{kind:`scalar`,type:`DateTime`,default:`now()`,...e}},updatedAt(e){return{kind:`scalar`,type:`DateTime`,updatedAt:!0,...e}},email(t){return{kind:`scalar`,type:`String`,zod:e.email(),...t}},url(t){return{kind:`scalar`,type:`String`,zod:e.url(),...t}},enum(e,t){return{kind:`enum`,enumName:e,...t}},inlineEnum(e,t,n){return{kind:`enum`,enumName:e,values:t,...n}},hasOne(e,t){return{kind:`relation`,type:`hasOne`,target:e,...t}},hasMany(e,t){return{kind:`relation`,type:`hasMany`,target:e,...t}},belongsTo(e,t,n,r){return{kind:`relation`,type:`belongsTo`,target:e,fields:t,references:n,...r}},foreignKey(e){return{kind:`scalar`,type:`String`,...e}}},i={on(e,t){return{fields:e,...t}},unique(e,t){return{fields:e,unique:!0,...t}},compound(e,t,n){return{fields:e,sort:t,...n}}};export{i,n,r,t};

package/dist/schema/dist/entity/index.js

@@ -0,0 +1 @@
+import{i as e,n as t,r as n,t as r}from"./defineEntity.js";import"./types.js";

package/dist/schema/dist/entity/types.js

@@ -0,0 +1 @@
+import{z as e}from"zod";

package/dist/schema/dist/index.js

@@ -0,0 +1 @@
+import"./EnumType.js";import{n as e}from"./FieldType.js";import{l as t}from"./ScalarTypeEnum.js";import{n,t as r}from"./SchemaModel.js";import{i,n as a,r as o,t as s}from"./entity/defineEntity.js";import"./entity/index.js";

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@lssm/lib.jobs",
+  "version": "0.0.0-canary-20251206160926",
+  "description": "Background jobs and scheduler module for ContractSpec applications",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "build": "bun build:bundle && bun build:types",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src"
+  },
+  "dependencies": {
+    "@lssm/lib.schema": "workspace:*",
+    "@lssm/lib.contracts": "workspace:*",
+    "zod": "^4.1.13",
+    "cron-parser": "^5.4.0"
+  },
+  "devDependencies": {
+    "@lssm/tool.typescript": "workspace:*",
+    "@lssm/tool.tsdown": "workspace:*",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./contracts": "./dist/contracts/index.js",
+    "./entities": "./dist/entities/index.js",
+    "./events": "./dist/events.js",
+    "./queue": "./dist/queue/index.js",
+    "./queue/memory-queue": "./dist/queue/memory-queue.js",
+    "./queue/types": "./dist/queue/types.js",
+    "./scheduler": "./dist/scheduler/index.js",
+    "./*": "./*"
+  },
+  "module": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}