@justscale/core 0.1.0

package/dist/models/reference/transient-ref.d.ts

@@ -0,0 +1,123 @@
+/**
+ * TransientRef - A reference to an unsaved (transient) entity.
+ *
+ * Unlike Reference<T> which holds an ID, TransientRef holds the actual
+ * entity instance. When the entity is saved, TransientRef can be
+ * converted to a regular Reference.
+ *
+ * Used for building entity graphs before persistence.
+ *
+ * @example
+ * ```typescript
+ * const User = defineModel('User', {
+ *   name: field.string(),
+ * });
+ *
+ * const Post = defineModel('Post', {
+ *   title: field.string(),
+ *   author: field.ref(User),
+ * });
+ *
+ * // Create an unsaved user
+ * const user = new User({ name: 'Alice' });
+ *
+ * // Reference it before saving
+ * const post = new Post({
+ *   title: 'My Post',
+ *   author: new TransientRef(user),
+ * });
+ *
+ * // Later, after saving the user, convert to regular Reference
+ * await userRepo.save(user);
+ * const authorRef = post.author.toReference(); // Now has ID
+ * ```
+ */
+import type { Persistent } from '../types.js';
+import { TRANSIENT_REF, TRANSIENT_TARGET } from '../symbols.js';
+import { Reference } from './reference.js';
+/**
+ * A reference to an unsaved (transient) entity that implements PromiseLike.
+ *
+ * The transient reference holds:
+ * - The entity instance (always available synchronously)
+ * - No ID (until the entity is saved)
+ *
+ * TransientRef implements PromiseLike, so you can await it to get the entity:
+ *   const author = await post.author; // Works for both Reference and TransientRef
+ *
+ * @example
+ * ```typescript
+ * const User = defineModel('User', {
+ *   name: field.string(),
+ * });
+ *
+ * const user = new User({ name: 'Alice' });
+ * const ref = new TransientRef(user);
+ *
+ * // Await to get the entity
+ * const entity = await ref;
+ *
+ * // Or access synchronously
+ * ref.target;    // User instance
+ * ref.isLoaded;  // Always true for TransientRef
+ *
+ * // After saving, convert to Reference
+ * await userRepo.save(user);
+ * const persistentRef = ref.toReference(); // Reference<User>
+ * ```
+ */
+export declare class TransientRef<T> implements PromiseLike<T | Persistent<T>> {
+    /** Symbol marker for type identification */
+    readonly [TRANSIENT_REF]: true;
+    /** Internal target entity storage */
+    private readonly [TRANSIENT_TARGET];
+    constructor(target: T | Persistent<T>);
+    /** The referenced entity - always available synchronously */
+    get target(): T | Persistent<T>;
+    /** Whether the reference is loaded - always true for TransientRef */
+    get isLoaded(): boolean;
+    /** The resolved entity - same as target for TransientRef */
+    get value(): T | Persistent<T>;
+    /** The resolved entity or null - never null for TransientRef */
+    get valueOrNull(): T | Persistent<T>;
+    /**
+     * Implement PromiseLike - makes the transient reference directly awaitable.
+     *
+     * `await post.author` works whether author is a Reference or TransientRef.
+     *
+     * For TransientRef, this resolves immediately (synchronously) to the target entity.
+     */
+    then<TResult1 = T | Persistent<T>, TResult2 = never>(onfulfilled?: ((value: T | Persistent<T>) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined): PromiseLike<TResult1 | TResult2>;
+    /**
+     * Convert this transient reference to a regular Reference.
+     *
+     * This requires the entity to have been persisted (must have an id).
+     * Throws if the entity doesn't have an ID yet.
+     *
+     * @throws Error if the entity doesn't have an id
+     *
+     * @example
+     * ```typescript
+     * const user = new User({ name: 'Alice' });
+     * const ref = new TransientRef(user);
+     *
+     * await userRepo.save(user); // Now user has an id
+     * const persistentRef = ref.toReference(); // Reference<User>
+     * ```
+     */
+    toReference(): Reference<T>;
+    /**
+     * Check if this transient reference can be converted to a Reference.
+     * Returns true if the entity has been persisted (has an adapter key).
+     */
+    canConvert(): boolean;
+    /**
+     * Create a transient reference to an entity.
+     */
+    static create<T>(target: T | Persistent<T>): TransientRef<T>;
+}
+/**
+ * Type guard to check if a value is a TransientRef.
+ */
+export declare function isTransientRef<T>(value: unknown): value is TransientRef<T>;
+//# sourceMappingURL=transient-ref.d.ts.map

package/dist/models/reference/transient-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-ref.d.ts","sourceRoot":"","sources":["../../../src/models/reference/transient-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAA2B,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,YAAY,CAAC,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACpE,4CAA4C;IAC5C,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAG,IAAI,CAAU;IAEzC,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,CAAC,gBAAgB,CAAC,CAAoB;gBAE3C,MAAM,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAIrC,6DAA6D;IAC7D,IAAI,MAAM,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAE9B;IAED,qEAAqE;IACrE,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,4DAA4D;IAC5D,IAAI,KAAK,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAE7B;IAED,gEAAgE;IAChE,IAAI,WAAW,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAEnC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,EACjD,WAAW,CAAC,EACR,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAChE,IAAI,GACJ,SAAS,EACb,UAAU,CAAC,EACP,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GACvD,IAAI,GACJ,SAAS,GACZ,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAKnC;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC;IAa3B;;;OAGG;IACH,UAAU,IAAI,OAAO;IAKrB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;CAG7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAO1E"}

package/dist/models/reference/transient-ref.js

@@ -0,0 +1,152 @@
+/**
+ * TransientRef - A reference to an unsaved (transient) entity.
+ *
+ * Unlike Reference<T> which holds an ID, TransientRef holds the actual
+ * entity instance. When the entity is saved, TransientRef can be
+ * converted to a regular Reference.
+ *
+ * Used for building entity graphs before persistence.
+ *
+ * @example
+ * ```typescript
+ * const User = defineModel('User', {
+ *   name: field.string(),
+ * });
+ *
+ * const Post = defineModel('Post', {
+ *   title: field.string(),
+ *   author: field.ref(User),
+ * });
+ *
+ * // Create an unsaved user
+ * const user = new User({ name: 'Alice' });
+ *
+ * // Reference it before saving
+ * const post = new Post({
+ *   title: 'My Post',
+ *   author: new TransientRef(user),
+ * });
+ *
+ * // Later, after saving the user, convert to regular Reference
+ * await userRepo.save(user);
+ * const authorRef = post.author.toReference(); // Now has ID
+ * ```
+ */
+import { TRANSIENT_REF, TRANSIENT_TARGET, ADAPTER_KEY, PERSISTENT } from '../symbols.js';
+import { Reference } from './reference.js';
+/**
+ * A reference to an unsaved (transient) entity that implements PromiseLike.
+ *
+ * The transient reference holds:
+ * - The entity instance (always available synchronously)
+ * - No ID (until the entity is saved)
+ *
+ * TransientRef implements PromiseLike, so you can await it to get the entity:
+ *   const author = await post.author; // Works for both Reference and TransientRef
+ *
+ * @example
+ * ```typescript
+ * const User = defineModel('User', {
+ *   name: field.string(),
+ * });
+ *
+ * const user = new User({ name: 'Alice' });
+ * const ref = new TransientRef(user);
+ *
+ * // Await to get the entity
+ * const entity = await ref;
+ *
+ * // Or access synchronously
+ * ref.target;    // User instance
+ * ref.isLoaded;  // Always true for TransientRef
+ *
+ * // After saving, convert to Reference
+ * await userRepo.save(user);
+ * const persistentRef = ref.toReference(); // Reference<User>
+ * ```
+ */
+export class TransientRef {
+    /** Symbol marker for type identification */
+    [TRANSIENT_REF] = true;
+    /** Internal target entity storage */
+    [TRANSIENT_TARGET];
+    constructor(target) {
+        this[TRANSIENT_TARGET] = target;
+    }
+    /** The referenced entity - always available synchronously */
+    get target() {
+        return this[TRANSIENT_TARGET];
+    }
+    /** Whether the reference is loaded - always true for TransientRef */
+    get isLoaded() {
+        return true;
+    }
+    /** The resolved entity - same as target for TransientRef */
+    get value() {
+        return this[TRANSIENT_TARGET];
+    }
+    /** The resolved entity or null - never null for TransientRef */
+    get valueOrNull() {
+        return this[TRANSIENT_TARGET];
+    }
+    /**
+     * Implement PromiseLike - makes the transient reference directly awaitable.
+     *
+     * `await post.author` works whether author is a Reference or TransientRef.
+     *
+     * For TransientRef, this resolves immediately (synchronously) to the target entity.
+     */
+    then(onfulfilled, onrejected) {
+        // Always resolve immediately with the target entity
+        return Promise.resolve(this[TRANSIENT_TARGET]).then(onfulfilled, onrejected);
+    }
+    /**
+     * Convert this transient reference to a regular Reference.
+     *
+     * This requires the entity to have been persisted (must have an id).
+     * Throws if the entity doesn't have an ID yet.
+     *
+     * @throws Error if the entity doesn't have an id
+     *
+     * @example
+     * ```typescript
+     * const user = new User({ name: 'Alice' });
+     * const ref = new TransientRef(user);
+     *
+     * await userRepo.save(user); // Now user has an id
+     * const persistentRef = ref.toReference(); // Reference<User>
+     * ```
+     */
+    toReference() {
+        const entity = this[TRANSIENT_TARGET];
+        const key = entity[ADAPTER_KEY];
+        if (!key) {
+            throw new Error('Cannot convert TransientRef to Reference: entity has no adapter key. Save the entity first.');
+        }
+        return Reference.resolved(key, entity);
+    }
+    /**
+     * Check if this transient reference can be converted to a Reference.
+     * Returns true if the entity has been persisted (has an adapter key).
+     */
+    canConvert() {
+        const entity = this[TRANSIENT_TARGET];
+        return !!(entity[ADAPTER_KEY] ?? entity[PERSISTENT]);
+    }
+    /**
+     * Create a transient reference to an entity.
+     */
+    static create(target) {
+        return new TransientRef(target);
+    }
+}
+/**
+ * Type guard to check if a value is a TransientRef.
+ */
+export function isTransientRef(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        TRANSIENT_REF in value &&
+        value[TRANSIENT_REF] === true);
+}
+//# sourceMappingURL=transient-ref.js.map

package/dist/models/reference/transient-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-ref.js","sourceRoot":"","sources":["../../../src/models/reference/transient-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,OAAO,YAAY;IACvB,4CAA4C;IACnC,CAAC,aAAa,CAAC,GAAG,IAAa,CAAC;IAEzC,qCAAqC;IACpB,CAAC,gBAAgB,CAAC,CAAoB;IAEvD,YAAY,MAAyB;QACnC,IAAI,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC;IAClC,CAAC;IAED,6DAA6D;IAC7D,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChC,CAAC;IAED,qEAAqE;IACrE,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4DAA4D;IAC5D,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChC,CAAC;IAED,gEAAgE;IAChE,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CACF,WAGa,EACb,UAGa;QAEb,oDAAoD;QACpD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAqC,CAAC;QAC1E,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAuB,CAAC;QAEtD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAuB,CAAiB,CAAC;IAC1E,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAqC,CAAC;QAC1E,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAI,MAAyB;QACxC,OAAO,IAAI,YAAY,CAAI,MAAM,CAAC,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAI,KAAc;IAC9C,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,aAAa,IAAI,KAAK;QACrB,KAAiC,CAAC,aAAa,CAAC,KAAK,IAAI,CAC3D,CAAC;AACJ,CAAC"}

package/dist/models/repository.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Repository Base
+ *
+ * Generic empty base class for repositories, used by core's DI system.
+ * Repository<T> is intentionally empty - the contract depends on context:
+ * ModelRepository adds CRUD operations; custom repositories define their own.
+ */
+/** Symbol to identify repository tokens */
+export declare const REPO_TOKEN: unique symbol;
+/** Symbol to brand Repository instances for type checking */
+export declare const REPO_BRAND: unique symbol;
+/**
+ * Abstract base class for all repositories.
+ *
+ * Intentionally empty - subclasses define their own contracts.
+ * Exists so core's DI system can work with any kind of repository.
+ *
+ * @typeParam T - The type this repository provides access to
+ */
+export declare abstract class Repository<T = unknown> {
+    /** Brand to distinguish Repository from plain objects in type checking */
+    readonly [REPO_BRAND]: true;
+}
+/** Brand for type-level token identification */
+declare const TOKEN_BRAND: unique symbol;
+/**
+ * A generic repository token for dependency injection.
+ *
+ * This is the base token interface that all repository tokens extend.
+ * Core's DI system uses this to wire up repositories without knowing
+ * about the specific contract.
+ *
+ * @typeParam T - The entity type this repository provides access to
+ * @typeParam TInstance - The repository instance type (defaults to Repository<T>)
+ */
+export interface RepositoryToken<T = unknown, TInstance = Repository<T>> {
+    /** Type brand - makes Token<A> incompatible with Token<B> */
+    readonly [TOKEN_BRAND]?: T;
+    /** Instance type brand - carries the actual instance type for DI */
+    readonly __instanceType?: TInstance;
+    /** Symbol brand - runtime identification */
+    readonly [REPO_TOKEN]: true;
+    /** Human-readable description */
+    readonly description: string;
+    /** String representation */
+    toString(): string;
+}
+/**
+ * Check if a value is a RepositoryToken.
+ */
+export declare function isRepositoryToken(value: unknown): value is RepositoryToken;
+export {};
+//# sourceMappingURL=repository.d.ts.map

package/dist/models/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/models/repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,2CAA2C;AAC3C,eAAO,MAAM,UAAU,eAAiC,CAAC;AAEzD,6DAA6D;AAC7D,eAAO,MAAM,UAAU,eAAiC,CAAC;AAMzD;;;;;;;GAOG;AACH,8BAAsB,UAAU,CAAC,CAAC,GAAG,OAAO;IAC1C,0EAA0E;IAC1E,SAAiB,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;CACrC;AAMD,gDAAgD;AAChD,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAC;AAEzC;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC;IACrE,6DAA6D;IAC7D,QAAQ,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAA;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAA;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAA;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,4BAA4B;IAC5B,QAAQ,IAAI,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E"}

package/dist/models/repository.js

@@ -0,0 +1,37 @@
+/**
+ * Repository Base
+ *
+ * Generic empty base class for repositories, used by core's DI system.
+ * Repository<T> is intentionally empty - the contract depends on context:
+ * ModelRepository adds CRUD operations; custom repositories define their own.
+ */
+// ============================================================================
+// Symbols
+// ============================================================================
+/** Symbol to identify repository tokens */
+export const REPO_TOKEN = Symbol('core:repositoryToken');
+/** Symbol to brand Repository instances for type checking */
+export const REPO_BRAND = Symbol('core:repositoryBrand');
+// ============================================================================
+// Repository Base Class
+// ============================================================================
+/**
+ * Abstract base class for all repositories.
+ *
+ * Intentionally empty - subclasses define their own contracts.
+ * Exists so core's DI system can work with any kind of repository.
+ *
+ * @typeParam T - The type this repository provides access to
+ */
+export class Repository {
+}
+/**
+ * Check if a value is a RepositoryToken.
+ */
+export function isRepositoryToken(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        REPO_TOKEN in value &&
+        value[REPO_TOKEN] === true);
+}
+//# sourceMappingURL=repository.js.map

package/dist/models/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/models/repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAEzD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAEzD,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,OAAgB,UAAU;CAG/B;AAgCD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,UAAU,IAAI,KAAK;QAClB,KAAiC,CAAC,UAAU,CAAC,KAAK,IAAI,CACxD,CAAC;AACJ,CAAC"}

package/dist/models/scheduled-task/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Scheduled Task System
+ *
+ * Provides durable task scheduling with exactly-once delivery.
+ * Used for process delays, scheduled jobs, reminders, etc.
+ *
+ * For the route factory, see @justscale/scheduled-task
+ */
+export { ScheduledTask, ScheduledTaskStatus } from './scheduled-task.js';
+export type { ScheduledTaskStatus as ScheduledTaskStatusType } from './scheduled-task.js';
+export { ScheduledTaskRepository } from './scheduled-task.repository.js';
+export type { ScheduleOptions, SubscribeOptions } from './scheduled-task.repository.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/scheduled-task/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/scheduled-task/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,YAAY,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/models/scheduled-task/index.js

@@ -0,0 +1,12 @@
+/**
+ * Scheduled Task System
+ *
+ * Provides durable task scheduling with exactly-once delivery.
+ * Used for process delays, scheduled jobs, reminders, etc.
+ *
+ * For the route factory, see @justscale/scheduled-task
+ */
+// Model and Repository
+export { ScheduledTask, ScheduledTaskStatus } from './scheduled-task.js';
+export { ScheduledTaskRepository } from './scheduled-task.repository.js';
+//# sourceMappingURL=index.js.map

package/dist/models/scheduled-task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/scheduled-task/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uBAAuB;AACvB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAGzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/models/scheduled-task/scheduled-task.d.ts

@@ -0,0 +1,73 @@
+/**
+ * ScheduledTask Model
+ *
+ * A scheduled task represents work to be executed at a specific time.
+ * Used for durable timers in processes, scheduled jobs, reminders, etc.
+ *
+ * Tasks are identified by namespace.type (e.g., 'process.delay', 'email.reminder').
+ * Workers subscribe to specific qualified names and receive tasks as an async iterable.
+ *
+ * @example
+ * ```typescript
+ * // Schedule a process delay
+ * await scheduler.schedule({
+ *   dueAt: new Date(Date.now() + 60_000),
+ *   namespace: 'process',
+ *   type: 'delay',
+ *   payload: { processId: 'abc', instanceId: '123' },
+ * })
+ *
+ * // Subscribe to process delays
+ * for await (const task of scheduler.subscribe('process.delay')) {
+ *   await resumeProcess(task.payload)
+ * }
+ * ```
+ */
+/**
+ * Task status values.
+ */
+export declare const ScheduledTaskStatus: {
+    /** Task is waiting to be executed */
+    readonly Pending: "pending";
+    /** Task is currently being processed */
+    readonly Processing: "processing";
+    /** Task completed successfully */
+    readonly Completed: "completed";
+    /** Task was cancelled before execution */
+    readonly Cancelled: "cancelled";
+    /** Task failed during execution */
+    readonly Failed: "failed";
+};
+export type ScheduledTaskStatus = (typeof ScheduledTaskStatus)[keyof typeof ScheduledTaskStatus];
+declare const ScheduledTask_base: import("../define-model.js").Model<{
+    readonly dueAt: Date;
+    readonly namespace: string;
+    readonly type: string;
+    readonly payload: unknown;
+    readonly status: "pending" | "completed" | "failed" | "cancelled" | "processing";
+    readonly startedAt: Date | undefined;
+    readonly completedAt: Date | undefined;
+    readonly error: string | undefined;
+}, string, {}, "status", {}>;
+/**
+ * ScheduledTask model.
+ *
+ * Represents a task scheduled to run at a specific time.
+ */
+export declare class ScheduledTask extends ScheduledTask_base {
+    /**
+     * Get the fully qualified task name.
+     * Format: namespace.type (e.g., 'process.delay')
+     */
+    get qualifiedName(): string;
+    /**
+     * Check if the task is due for execution.
+     */
+    isDue(now?: Date): boolean;
+    /**
+     * Check if the task can still be cancelled.
+     */
+    get isCancellable(): boolean;
+}
+export {};
+//# sourceMappingURL=scheduled-task.d.ts.map

package/dist/models/scheduled-task/scheduled-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task.d.ts","sourceRoot":"","sources":["../../../src/models/scheduled-task/scheduled-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,qCAAqC;;IAErC,wCAAwC;;IAExC,kCAAkC;;IAElC,0CAA0C;;IAE1C,mCAAmC;;CAE3B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;;;;;;;;;;;AAEjG;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,kBA0BjC;IACA;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,OAAa,GAAG,OAAO;IAIhC;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;CACF"}

package/dist/models/scheduled-task/scheduled-task.js

@@ -0,0 +1,95 @@
+/**
+ * ScheduledTask Model
+ *
+ * A scheduled task represents work to be executed at a specific time.
+ * Used for durable timers in processes, scheduled jobs, reminders, etc.
+ *
+ * Tasks are identified by namespace.type (e.g., 'process.delay', 'email.reminder').
+ * Workers subscribe to specific qualified names and receive tasks as an async iterable.
+ *
+ * @example
+ * ```typescript
+ * // Schedule a process delay
+ * await scheduler.schedule({
+ *   dueAt: new Date(Date.now() + 60_000),
+ *   namespace: 'process',
+ *   type: 'delay',
+ *   payload: { processId: 'abc', instanceId: '123' },
+ * })
+ *
+ * // Subscribe to process delays
+ * for await (const task of scheduler.subscribe('process.delay')) {
+ *   await resumeProcess(task.payload)
+ * }
+ * ```
+ */
+import { defineModel } from '../define-model.js';
+import { field } from '../field.js';
+/**
+ * Task status values.
+ */
+export const ScheduledTaskStatus = {
+    /** Task is waiting to be executed */
+    Pending: 'pending',
+    /** Task is currently being processed */
+    Processing: 'processing',
+    /** Task completed successfully */
+    Completed: 'completed',
+    /** Task was cancelled before execution */
+    Cancelled: 'cancelled',
+    /** Task failed during execution */
+    Failed: 'failed',
+};
+/**
+ * ScheduledTask model.
+ *
+ * Represents a task scheduled to run at a specific time.
+ */
+export class ScheduledTask extends defineModel({
+    name: 'JustScale_ScheduledTask',
+    fields: {
+        /** When the task should be executed */
+        dueAt: field.timestamp(),
+        /** Task namespace (e.g., 'process', 'email', 'notifications') */
+        namespace: field.string().max(64).index(),
+        /** Task type within namespace (e.g., 'delay', 'reminder', 'cleanup') */
+        type: field.string().max(64).index(),
+        /** Task payload - the data needed to execute the task */
+        payload: field.json(),
+        /** Current task status */
+        status: field.enum('scheduled_task_status', [
+            'pending',
+            'processing',
+            'completed',
+            'cancelled',
+            'failed',
+        ]).default('pending'),
+        /** When the task started processing (set when picked up) */
+        startedAt: field.timestamp().optional(),
+        /** When the task completed/failed (set on completion) */
+        completedAt: field.timestamp().optional(),
+        /** Error message if task failed */
+        error: field.text().optional(),
+    },
+}) {
+    /**
+     * Get the fully qualified task name.
+     * Format: namespace.type (e.g., 'process.delay')
+     */
+    get qualifiedName() {
+        return `${this.namespace}.${this.type}`;
+    }
+    /**
+     * Check if the task is due for execution.
+     */
+    isDue(now = new Date()) {
+        return this.dueAt <= now && this.status === 'pending';
+    }
+    /**
+     * Check if the task can still be cancelled.
+     */
+    get isCancellable() {
+        return this.status === 'pending';
+    }
+}
+//# sourceMappingURL=scheduled-task.js.map

package/dist/models/scheduled-task/scheduled-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task.js","sourceRoot":"","sources":["../../../src/models/scheduled-task/scheduled-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,qCAAqC;IACrC,OAAO,EAAE,SAAS;IAClB,wCAAwC;IACxC,UAAU,EAAE,YAAY;IACxB,kCAAkC;IAClC,SAAS,EAAE,WAAW;IACtB,0CAA0C;IAC1C,SAAS,EAAE,WAAW;IACtB,mCAAmC;IACnC,MAAM,EAAE,QAAQ;CACR,CAAC;AAIX;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,WAAW,CAAC;IAC7C,IAAI,EAAE,yBAAyB;IAC/B,MAAM,EAAE;QACN,uCAAuC;QACvC,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE;QACxB,iEAAiE;QACjE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE;QACzC,wEAAwE;QACxE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE;QACpC,yDAAyD;QACzD,OAAO,EAAE,KAAK,CAAC,IAAI,EAAW;QAC9B,0BAA0B;QAC1B,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE;YAC1C,SAAS;YACT,YAAY;YACZ,WAAW;YACX,WAAW;YACX,QAAQ;SACA,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC9B,4DAA4D;QAC5D,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE;QACvC,yDAAyD;QACzD,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE;QACzC,mCAAmC;QACnC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;KAC/B;CACF,CAAC;IACA;;;OAGG;IACH,IAAI,aAAa;QACf,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE;QACpB,OAAO,IAAI,CAAC,KAAK,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IACnC,CAAC;CACF"}