@mj-biz-apps/issues-core-entities-server 0.0.1 → 1.0.0

package/dist/IssueEntityServer.d.ts

@@ -0,0 +1,53 @@
+import { EntitySaveOptions } from '@memberjunction/core';
+import { mjBizAppsIssuesIssueEntity } from '@mj-biz-apps/issues-entities';
+/**
+ * Server-side subclass of {@link mjBizAppsIssuesIssueEntity}.
+ *
+ * Owns the SERVER-ONLY lifecycle side-effects that must fire on EVERY save path
+ * (UI, API, automation) — not just when callers route through IssueService:
+ *
+ *   1. **IssueNumber assignment** (insert only) — via the atomic
+ *      spAssignNextIssueNumber proc, before super.Save(); immutable thereafter.
+ *   2. **Lifecycle timestamp stamping** (in Save(), before super.Save()) — when
+ *      StatusID changes: stamp ResolvedAt on entering a Resolved/Terminal status,
+ *      ClosedAt on entering a Terminal status, and clear them on reopen. These
+ *      mutate the row being written, so they happen inline.
+ *   3. **IssueType action hooks** (post-save, via RegisterEventHandler) — fire
+ *      OnCreate (insert), OnStatusChange (+ OnClose on terminal), and OnAssign
+ *      (assignee change) through the Action engine. These are decoupled reactions
+ *      that must NOT be able to fail or slow the save, so they run after the save
+ *      event finalizes — mirroring bizapps-tasks' TaskNotificationHandler and
+ *      SaaS's OrganizationPersonRoleEntityServer event-handler pattern.
+ *
+ * Registered at priority 2 so this server subclass wins over the priority-1
+ * client-shared entity.
+ */
+export declare class IssueEntityServer extends mjBizAppsIssuesIssueEntity {
+    private _hookHandlerRegistered;
+    Save(options?: EntitySaveOptions): Promise<boolean>;
+    /** Allocates and sets IssueNumber for a new Issue based on its AppScope. */
+    private assignIssueNumber;
+    /**
+     * Stamps ResolvedAt / ClosedAt based on the NEW status's flags:
+     *  - entering an IsResolved OR IsTerminal status → set ResolvedAt (if not already set)
+     *  - entering an IsTerminal status → set ClosedAt
+     *  - leaving into a non-terminal, non-resolved (active) status (reopen) → clear both
+     * Loads the engine for the IsResolved/IsTerminal lookup.
+     */
+    private stampLifecycleTimestamps;
+    private _pendingHookContext;
+    /**
+     * Registers a per-instance save-event handler (once) that fires the IssueType
+     * action hooks AFTER the save finalizes. Fire-and-forget; failures are logged,
+     * never propagated — a misconfigured hook must not break the save.
+     */
+    private ensureHookHandler;
+    /** Dispatches the IssueType action hooks for the events that occurred this save. */
+    private fireLifecycleHooks;
+    /**
+     * Fires a single IssueType action hook by Action ID, passing the issue's identity
+     * as input params. No-op when actionID is null. Failures are logged, not thrown.
+     */
+    private fireHook;
+}
+//# sourceMappingURL=IssueEntityServer.d.ts.map

package/dist/IssueEntityServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IssueEntityServer.d.ts","sourceRoot":"","sources":["../src/IssueEntityServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,iBAAiB,EAAsB,MAAM,sBAAsB,CAAC;AAI1G,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAK1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBACa,iBAAkB,SAAQ,0BAA0B;IAC/D,OAAO,CAAC,sBAAsB,CAAS;IAEjB,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAmCzE,4EAA4E;YAC9D,iBAAiB;IAc/B;;;;;;OAMG;YACW,wBAAwB;IA6BtC,OAAO,CAAC,mBAAmB,CAA4B;IAEvD;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAsBzB,oFAAoF;YACtE,kBAAkB;IAqBhC;;;OAGG;YACW,QAAQ;CAiCvB"}

package/dist/IssueEntityServer.js

@@ -0,0 +1,201 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseEntity, LogError } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { ActionEngineServer } from '@memberjunction/actions';
+import { mjBizAppsIssuesIssueEntity } from '@mj-biz-apps/issues-entities';
+import { IssueEngine } from '@mj-biz-apps/issues-core';
+import { SequenceService } from './SequenceService.js';
+/**
+ * Server-side subclass of {@link mjBizAppsIssuesIssueEntity}.
+ *
+ * Owns the SERVER-ONLY lifecycle side-effects that must fire on EVERY save path
+ * (UI, API, automation) — not just when callers route through IssueService:
+ *
+ *   1. **IssueNumber assignment** (insert only) — via the atomic
+ *      spAssignNextIssueNumber proc, before super.Save(); immutable thereafter.
+ *   2. **Lifecycle timestamp stamping** (in Save(), before super.Save()) — when
+ *      StatusID changes: stamp ResolvedAt on entering a Resolved/Terminal status,
+ *      ClosedAt on entering a Terminal status, and clear them on reopen. These
+ *      mutate the row being written, so they happen inline.
+ *   3. **IssueType action hooks** (post-save, via RegisterEventHandler) — fire
+ *      OnCreate (insert), OnStatusChange (+ OnClose on terminal), and OnAssign
+ *      (assignee change) through the Action engine. These are decoupled reactions
+ *      that must NOT be able to fail or slow the save, so they run after the save
+ *      event finalizes — mirroring bizapps-tasks' TaskNotificationHandler and
+ *      SaaS's OrganizationPersonRoleEntityServer event-handler pattern.
+ *
+ * Registered at priority 2 so this server subclass wins over the priority-1
+ * client-shared entity.
+ */
+let IssueEntityServer = class IssueEntityServer extends mjBizAppsIssuesIssueEntity {
+    constructor() {
+        super(...arguments);
+        this._hookHandlerRegistered = false;
+        // ------------------------------------------------------------------
+        // 3. Action hooks (post-save reaction via event handler)
+        // ------------------------------------------------------------------
+        this._pendingHookContext = null;
+    }
+    async Save(options) {
+        this.ensureHookHandler();
+        const isNew = !this.IsSaved;
+        // Snapshot the status transition BEFORE super.Save() resets dirty flags.
+        const statusField = this.GetFieldByName('StatusID');
+        const statusChanged = statusField?.Dirty ?? false;
+        const oldStatusID = statusField?.OldValue ?? null;
+        const assigneeField = this.GetFieldByName('AssigneeRecordID');
+        const assigneeEntityField = this.GetFieldByName('AssigneeEntityID');
+        const assigneeChanged = (assigneeField?.Dirty ?? false) || (assigneeEntityField?.Dirty ?? false);
+        // 1. IssueNumber (insert only, immutable)
+        if (isNew && !this.IssueNumber) {
+            await this.assignIssueNumber();
+        }
+        // 2. Lifecycle timestamps — stamp inline so they're part of this write.
+        //    On insert, treat the initial status as "entered" too.
+        if (statusChanged || isNew) {
+            await this.stampLifecycleTimestamps();
+        }
+        // Stash what the post-save hook handler needs (dirty flags are gone after save).
+        this._pendingHookContext = { isNew, statusChanged: statusChanged && !isNew, oldStatusID, assigneeChanged: assigneeChanged && !isNew };
+        return super.Save(options);
+    }
+    // ------------------------------------------------------------------
+    // 1. IssueNumber assignment
+    // ------------------------------------------------------------------
+    /** Allocates and sets IssueNumber for a new Issue based on its AppScope. */
+    async assignIssueNumber() {
+        try {
+            this.IssueNumber = await SequenceService.assignNextIssueNumber(this.AppScope, this);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`IssueEntityServer: failed to assign IssueNumber (AppScope=${this.AppScope ?? '(null)'}): ${msg}`);
+            throw err;
+        }
+    }
+    // ------------------------------------------------------------------
+    // 2. Lifecycle timestamp stamping (inline, mutates the row)
+    // ------------------------------------------------------------------
+    /**
+     * Stamps ResolvedAt / ClosedAt based on the NEW status's flags:
+     *  - entering an IsResolved OR IsTerminal status → set ResolvedAt (if not already set)
+     *  - entering an IsTerminal status → set ClosedAt
+     *  - leaving into a non-terminal, non-resolved (active) status (reopen) → clear both
+     * Loads the engine for the IsResolved/IsTerminal lookup.
+     */
+    async stampLifecycleTimestamps() {
+        await IssueEngine.Instance.Config(false, this.ContextCurrentUser);
+        const isResolved = IssueEngine.Instance.IsResolvedStatus(this.StatusID);
+        const isTerminal = IssueEngine.Instance.IsTerminalStatus(this.StatusID);
+        const now = new Date();
+        if (isTerminal) {
+            if (!this.ResolvedAt) {
+                this.ResolvedAt = now;
+            }
+            this.ClosedAt = now;
+        }
+        else if (isResolved) {
+            if (!this.ResolvedAt) {
+                this.ResolvedAt = now;
+            }
+            // Resolved-but-not-closed: ensure not marked closed.
+            this.ClosedAt = null;
+        }
+        else {
+            // Active (reopened or never resolved): clear lifecycle stamps.
+            this.ResolvedAt = null;
+            this.ClosedAt = null;
+        }
+    }
+    /**
+     * Registers a per-instance save-event handler (once) that fires the IssueType
+     * action hooks AFTER the save finalizes. Fire-and-forget; failures are logged,
+     * never propagated — a misconfigured hook must not break the save.
+     */
+    ensureHookHandler() {
+        if (this._hookHandlerRegistered) {
+            return;
+        }
+        this._hookHandlerRegistered = true;
+        this.RegisterEventHandler((event) => {
+            if (event.type !== 'save') {
+                return;
+            }
+            const ctx = this._pendingHookContext;
+            this._pendingHookContext = null;
+            if (!ctx) {
+                return;
+            }
+            this.fireLifecycleHooks(ctx).catch((err) => {
+                const msg = err instanceof Error ? err.message : String(err);
+                LogError(`IssueEntityServer: lifecycle hook firing failed for issue ${this.ID}: ${msg}`);
+            });
+        });
+    }
+    /** Dispatches the IssueType action hooks for the events that occurred this save. */
+    async fireLifecycleHooks(ctx) {
+        await IssueEngine.Instance.Config(false, this.ContextCurrentUser);
+        const issueType = IssueEngine.Instance.IssueTypeByID(this.IssueTypeID);
+        if (!issueType) {
+            return;
+        }
+        if (ctx.isNew) {
+            await this.fireHook(issueType.OnCreateActionID);
+        }
+        if (ctx.statusChanged) {
+            await this.fireHook(issueType.OnStatusChangeActionID);
+            if (IssueEngine.Instance.IsTerminalStatus(this.StatusID)) {
+                await this.fireHook(issueType.OnCloseActionID);
+            }
+        }
+        if (ctx.assigneeChanged) {
+            await this.fireHook(issueType.OnAssignActionID);
+        }
+    }
+    /**
+     * Fires a single IssueType action hook by Action ID, passing the issue's identity
+     * as input params. No-op when actionID is null. Failures are logged, not thrown.
+     */
+    async fireHook(actionID) {
+        if (!actionID) {
+            return;
+        }
+        try {
+            const contextUser = this.ContextCurrentUser;
+            await ActionEngineServer.Instance.Config(false, contextUser);
+            const action = ActionEngineServer.Instance.Actions.find((a) => a.ID === actionID);
+            if (!action) {
+                LogError(`IssueEntityServer.fireHook: Action ${actionID} not found`);
+                return;
+            }
+            const params = [
+                { Name: 'IssueID', Value: this.ID, Type: 'Input' },
+                { Name: 'IssueNumber', Value: this.IssueNumber, Type: 'Input' },
+                { Name: 'Title', Value: this.Title, Type: 'Input' },
+                { Name: 'StatusID', Value: this.StatusID, Type: 'Input' },
+                { Name: 'Priority', Value: this.Priority, Type: 'Input' },
+                { Name: 'Severity', Value: this.Severity, Type: 'Input' },
+            ];
+            await ActionEngineServer.Instance.RunAction({
+                Action: action,
+                ContextUser: contextUser,
+                Params: params,
+                Filters: [],
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`IssueEntityServer.fireHook: failed to run Action ${actionID}: ${msg}`);
+        }
+    }
+};
+IssueEntityServer = __decorate([
+    RegisterClass(BaseEntity, 'MJ_BizApps_Issues: Issues', 2)
+], IssueEntityServer);
+export { IssueEntityServer };
+//# sourceMappingURL=IssueEntityServer.js.map

package/dist/IssueEntityServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IssueEntityServer.js","sourceRoot":"","sources":["../src/IssueEntityServer.ts"],"names":[],"mappings":"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"}

package/dist/SequenceService.d.ts

@@ -0,0 +1,48 @@
+import { BaseEntity } from '@memberjunction/core';
+/**
+ * SequenceService — calls the DB-level atomic numbering routine (spAssignNextIssueNumber)
+ * from TypeScript so the IssueEntityServer hook can assign IssueNumber before
+ * super.Save() commits the row.
+ *
+ * The routine is intentionally kept at DB level because it requires atomic
+ * read-modify-write semantics that don't translate safely to app-level code
+ * under concurrency. It normalizes the scope (trim/UPPER, null/blank → 'ISS')
+ * and returns the formatted, unpadded `{SCOPE}-{seq}`.
+ *
+ * Platform-aware: MemberJunction runs on SQL Server or PostgreSQL, and the two
+ * expose the routine differently —
+ *   * SQL Server: a PROCEDURE with an OUTPUT parameter, invoked via
+ *     `DECLARE @x …; EXEC … @IssueNumber = @x OUTPUT; SELECT @x`.
+ *   * PostgreSQL: a FUNCTION RETURNING TEXT (PG has no clean OUTPUT-param EXEC
+ *     idiom), invoked via `SELECT schema.spAssignNextIssueNumber(:scope)`. The
+ *     PG definition ships as a `.pg-only.sql` supplement under `migrations-pg/`.
+ * The dialect is selected from `DB_PLATFORM` (the same env var the MJ CLI and
+ * runtime use), defaulting to SQL Server when unset — matching the rest of the stack.
+ */
+export declare class SequenceService {
+    /**
+     * Atomically allocates the next IssueNumber for the given AppScope and returns the
+     * formatted value (e.g. `MJC-42`, or `ISS-7` when AppScope is null/blank).
+     *
+     * The provider is taken from the calling entity so the call runs on the same
+     * (per-request) provider that owns the entity — never the process-global default.
+     *
+     * @param appScope The Issue's AppScope (may be null/blank — the routine defaults it to 'ISS').
+     * @param entity   The Issue entity instance driving the save (supplies the provider + user).
+     */
+    static assignNextIssueNumber(appScope: string | null, entity: BaseEntity): Promise<string>;
+    /**
+     * SQL Server: call the OUTPUT-parameter procedure and surface its value as a column.
+     * The proc re-normalizes the scope regardless of what we pass; we inline it as an escaped
+     * literal (the verified pattern across MJ's generated resolvers, which pass `undefined` params).
+     */
+    private static buildSqlServerSQL;
+    /**
+     * PostgreSQL: call the function form and alias its scalar result to the `IssueNumber` column the
+     * caller reads. The function name is emitted UNQUOTED so PostgreSQL folds it to the same lowercase
+     * identifier the `CREATE FUNCTION` produced. The schema is likewise unquoted (folds to lowercase),
+     * matching how `mj codegen` and the MJServer runtime reference app-schema objects on PG.
+     */
+    private static buildPostgresSQL;
+}
+//# sourceMappingURL=SequenceService.d.ts.map

package/dist/SequenceService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SequenceService.d.ts","sourceRoot":"","sources":["../src/SequenceService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAkC,MAAM,sBAAsB,CAAC;AAKlF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAe;IAC1B;;;;;;;;;OASG;WACiB,qBAAqB,CACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,MAAM,CAAC;IAkClB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAWhC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAIhC"}

package/dist/SequenceService.js

@@ -0,0 +1,83 @@
+import { LogError } from '@memberjunction/core';
+import { resolveDbPlatformFromEnv } from '@memberjunction/generic-database-provider';
+const ISSUES_SCHEMA = '__mj_BizAppsIssues';
+/**
+ * SequenceService — calls the DB-level atomic numbering routine (spAssignNextIssueNumber)
+ * from TypeScript so the IssueEntityServer hook can assign IssueNumber before
+ * super.Save() commits the row.
+ *
+ * The routine is intentionally kept at DB level because it requires atomic
+ * read-modify-write semantics that don't translate safely to app-level code
+ * under concurrency. It normalizes the scope (trim/UPPER, null/blank → 'ISS')
+ * and returns the formatted, unpadded `{SCOPE}-{seq}`.
+ *
+ * Platform-aware: MemberJunction runs on SQL Server or PostgreSQL, and the two
+ * expose the routine differently —
+ *   * SQL Server: a PROCEDURE with an OUTPUT parameter, invoked via
+ *     `DECLARE @x …; EXEC … @IssueNumber = @x OUTPUT; SELECT @x`.
+ *   * PostgreSQL: a FUNCTION RETURNING TEXT (PG has no clean OUTPUT-param EXEC
+ *     idiom), invoked via `SELECT schema.spAssignNextIssueNumber(:scope)`. The
+ *     PG definition ships as a `.pg-only.sql` supplement under `migrations-pg/`.
+ * The dialect is selected from `DB_PLATFORM` (the same env var the MJ CLI and
+ * runtime use), defaulting to SQL Server when unset — matching the rest of the stack.
+ */
+export class SequenceService {
+    /**
+     * Atomically allocates the next IssueNumber for the given AppScope and returns the
+     * formatted value (e.g. `MJC-42`, or `ISS-7` when AppScope is null/blank).
+     *
+     * The provider is taken from the calling entity so the call runs on the same
+     * (per-request) provider that owns the entity — never the process-global default.
+     *
+     * @param appScope The Issue's AppScope (may be null/blank — the routine defaults it to 'ISS').
+     * @param entity   The Issue entity instance driving the save (supplies the provider + user).
+     */
+    static async assignNextIssueNumber(appScope, entity) {
+        // ProviderToUse is typed IEntityDataProvider, but every concrete MJ provider (SQL Server /
+        // PostgreSQL) is a DatabaseProviderBase subclass that also implements IEntityDataProvider. The two
+        // interfaces don't structurally overlap, so TS requires the widening cast through `unknown` — this
+        // is the sanctioned mechanism for a cast between compatible-at-runtime types, NOT an `any` escape.
+        const provider = entity.ProviderToUse;
+        if (!provider) {
+            LogError('SequenceService.assignNextIssueNumber: entity has no provider');
+            throw new Error('SequenceService: no provider available on the entity');
+        }
+        // DB_PLATFORM defaults to SQL Server when unset (resolveDbPlatformFromEnv returns undefined).
+        const platform = resolveDbPlatformFromEnv() ?? 'sqlserver';
+        const sql = platform === 'postgresql'
+            ? this.buildPostgresSQL(appScope)
+            : this.buildSqlServerSQL(appScope);
+        const rows = await provider.ExecuteSQL(sql, undefined, { isMutation: true, description: 'spAssignNextIssueNumber' }, entity.ContextCurrentUser);
+        const value = rows?.[0]?.IssueNumber;
+        if (!value || typeof value !== 'string') {
+            throw new Error(`SequenceService.assignNextIssueNumber: routine returned no value for AppScope=${appScope ?? '(null)'}`);
+        }
+        return value;
+    }
+    /**
+     * SQL Server: call the OUTPUT-parameter procedure and surface its value as a column.
+     * The proc re-normalizes the scope regardless of what we pass; we inline it as an escaped
+     * literal (the verified pattern across MJ's generated resolvers, which pass `undefined` params).
+     */
+    static buildSqlServerSQL(appScope) {
+        const scopeLiteral = appScope == null ? 'NULL' : `N'${appScope.replace(/'/g, "''")}'`;
+        return `
+      DECLARE @issueNumber NVARCHAR(50);
+      EXEC ${ISSUES_SCHEMA}.spAssignNextIssueNumber
+          @AppScope = ${scopeLiteral},
+          @IssueNumber = @issueNumber OUTPUT;
+      SELECT @issueNumber AS IssueNumber;
+    `;
+    }
+    /**
+     * PostgreSQL: call the function form and alias its scalar result to the `IssueNumber` column the
+     * caller reads. The function name is emitted UNQUOTED so PostgreSQL folds it to the same lowercase
+     * identifier the `CREATE FUNCTION` produced. The schema is likewise unquoted (folds to lowercase),
+     * matching how `mj codegen` and the MJServer runtime reference app-schema objects on PG.
+     */
+    static buildPostgresSQL(appScope) {
+        const scopeLiteral = appScope == null ? 'NULL' : `'${appScope.replace(/'/g, "''")}'`;
+        return `SELECT ${ISSUES_SCHEMA}.spAssignNextIssueNumber(${scopeLiteral}) AS "IssueNumber";`;
+    }
+}
+//# sourceMappingURL=SequenceService.js.map

package/dist/SequenceService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SequenceService.js","sourceRoot":"","sources":["../src/SequenceService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAErF,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,eAAe;IAC1B;;;;;;;;;OASG;IACI,MAAM,CAAC,KAAK,CAAC,qBAAqB,CACvC,QAAuB,EACvB,MAAkB;QAElB,2FAA2F;QAC3F,mGAAmG;QACnG,mGAAmG;QACnG,mGAAmG;QACnG,MAAM,QAAQ,GAAG,MAAM,CAAC,aAA4D,CAAC;QACrF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,+DAA+D,CAAC,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,8FAA8F;QAC9F,MAAM,QAAQ,GAAG,wBAAwB,EAAE,IAAI,WAAW,CAAC;QAC3D,MAAM,GAAG,GACP,QAAQ,KAAK,YAAY;YACvB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;YACjC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAEvC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,UAAU,CACpC,GAAG,EACH,SAAS,EACT,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,yBAAyB,EAAE,EAC5D,MAAM,CAAC,kBAAkB,CAC1B,CAAC;QAEF,MAAM,KAAK,GAAI,IAAI,EAAE,CAAC,CAAC,CAA2C,EAAE,WAAW,CAAC;QAChF,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,iFAAiF,QAAQ,IAAI,QAAQ,EAAE,CACxG,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,iBAAiB,CAAC,QAAuB;QACtD,MAAM,YAAY,GAAG,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;QACtF,OAAO;;aAEE,aAAa;wBACF,YAAY;;;KAG/B,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,gBAAgB,CAAC,QAAuB;QACrD,MAAM,YAAY,GAAG,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;QACrF,OAAO,UAAU,aAAa,4BAA4B,YAAY,qBAAqB,CAAC;IAC9F,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @mj-biz-apps/issues-core-entities-server
+ *
+ * Server-side entity subclasses for BizApps Issues entities. These hold side-effects
+ * that must run server-only and authoritatively (not in the browser) — currently the
+ * assignment of the human-readable Issue.IssueNumber via an atomic DB sequence proc.
+ *
+ * Import this package (or call LoadBizAppsIssuesEntitiesServer) from the server
+ * bootstrap so the @RegisterClass decorators fire at startup.
+ */
+export { IssueEntityServer } from './IssueEntityServer.js';
+export { SequenceService } from './SequenceService.js';
+/**
+ * Forces the server-side entity subclasses to load so their @RegisterClass
+ * decorators register (priority 2, overriding the client-shared entities).
+ * Tree-shaking would otherwise drop them since they're referenced only via the
+ * class factory.
+ */
+export declare function LoadBizAppsIssuesEntitiesServer(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * @mj-biz-apps/issues-core-entities-server
+ *
+ * Server-side entity subclasses for BizApps Issues entities. These hold side-effects
+ * that must run server-only and authoritatively (not in the browser) — currently the
+ * assignment of the human-readable Issue.IssueNumber via an atomic DB sequence proc.
+ *
+ * Import this package (or call LoadBizAppsIssuesEntitiesServer) from the server
+ * bootstrap so the @RegisterClass decorators fire at startup.
+ */
+import { IssueEntityServer } from './IssueEntityServer.js';
+export { IssueEntityServer } from './IssueEntityServer.js';
+export { SequenceService } from './SequenceService.js';
+/**
+ * Forces the server-side entity subclasses to load so their @RegisterClass
+ * decorators register (priority 2, overriding the client-shared entities).
+ * Tree-shaking would otherwise drop them since they're referenced only via the
+ * class factory.
+ */
+export function LoadBizAppsIssuesEntitiesServer() {
+    // Reference the class so the import is retained and its decorator runs.
+    void IssueEntityServer;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B;IAC7C,wEAAwE;IACxE,KAAK,iBAAiB,CAAC;AACzB,CAAC"}

package/package.json

@@ -1,10 +1,40 @@
 {
   "name": "@mj-biz-apps/issues-core-entities-server",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @mj-biz-apps/issues-core-entities-server",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Server-side entity subclasses for BizApps Issues — lifecycle hooks for Issue, IssueComment, etc. (stamp ResolvedAt/ClosedAt, fire IssueType action hooks).",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@mj-biz-apps/issues-entities": "1.0.0",
+    "@mj-biz-apps/issues-core": "1.0.0"
+  },
+  "peerDependencies": {
+    "@memberjunction/core": "^5.40.2",
+    "@memberjunction/core-entities": "^5.40.2",
+    "@memberjunction/generic-database-provider": "^5.40.2",
+    "@memberjunction/global": "^5.40.2",
+    "@memberjunction/actions": "^5.40.2",
+    "@memberjunction/actions-base": "^5.40.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/bizapps-issues"
+  }
 }

package/README.md

@@ -1,45 +0,0 @@
-# @mj-biz-apps/issues-core-entities-server
-
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@mj-biz-apps/issues-core-entities-server`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**