@lti-tool/postgresql 1.0.0 → 1.0.1

package/dist/db/schema/registrationSessions.schema.d.ts

@@ -0,0 +1,62 @@
+import type { LTIDynamicRegistrationSession } from '@lti-tool/core';
+export declare const registrationSessionsTable: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "registration_sessions";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "registration_sessions";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        data: import("drizzle-orm/pg-core").PgColumn<{
+            name: "data";
+            tableName: "registration_sessions";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Omit<LTIDynamicRegistrationSession, "sessionId">;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Omit<LTIDynamicRegistrationSession, "sessionId">;
+        }>;
+        expiresAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "expires_at";
+            tableName: "registration_sessions";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+//# sourceMappingURL=registrationSessions.schema.d.ts.map

package/dist/db/schema/registrationSessions.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registrationSessions.schema.d.ts","sourceRoot":"","sources":["../../../src/db/schema/registrationSessions.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAGpE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUrC,CAAC"}

package/dist/db/schema/registrationSessions.schema.js

@@ -0,0 +1,8 @@
+import { index, jsonb, pgTable, timestamp, uuid } from 'drizzle-orm/pg-core';
+export const registrationSessionsTable = pgTable('registration_sessions', {
+    id: uuid('id').primaryKey().defaultRandom(),
+    data: jsonb('data')
+        .$type()
+        .notNull(),
+    expiresAt: timestamp('expires_at', { withTimezone: true }).notNull(),
+}, (table) => [index('reg_sessions_expires_at_idx').on(table.expiresAt)]);

package/dist/db/schema/sessions.schema.d.ts

@@ -0,0 +1,62 @@
+import type { LTISession } from '@lti-tool/core';
+export declare const sessionsTable: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "sessions";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "sessions";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        data: import("drizzle-orm/pg-core").PgColumn<{
+            name: "data";
+            tableName: "sessions";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Omit<LTISession, "id">;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Omit<LTISession, "id">;
+        }>;
+        expiresAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "expires_at";
+            tableName: "sessions";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+//# sourceMappingURL=sessions.schema.d.ts.map

package/dist/db/schema/sessions.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.schema.d.ts","sourceRoot":"","sources":["../../../src/db/schema/sessions.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQzB,CAAC"}

package/dist/db/schema/sessions.schema.js

@@ -0,0 +1,6 @@
+import { index, jsonb, pgTable, timestamp, uuid } from 'drizzle-orm/pg-core';
+export const sessionsTable = pgTable('sessions', {
+    id: uuid('id').primaryKey().defaultRandom(),
+    data: jsonb('data').$type().notNull(),
+    expiresAt: timestamp('expires_at', { withTimezone: true }).notNull(),
+}, (table) => [index('sessions_expires_at_idx').on(table.expiresAt)]);

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { PostgresStorage } from './postgresStorage.js';
+export type { PostgresStorageConfig } from './interfaces/postgresStorageConfig.js';
+//# 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,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export { PostgresStorage } from './postgresStorage.js';

package/dist/interfaces/postgresStorageConfig.d.ts

@@ -0,0 +1,35 @@
+import type { Logger } from 'pino';
+export interface PostgresStorageConfig {
+    logger?: Logger;
+    /**
+     * PostgreSQL connection URL in format: postgresql://user:password@host:port/database
+     * Compatible with DATABASE_URL environment variable used by most ORMs
+     */
+    connectionUrl: string;
+    /**
+     * Optional postgres.js connection options
+     */
+    poolOptions?: {
+        /**
+         * Maximum number of connections in the pool.
+         * Defaults to 1 in serverless environments, 10 otherwise.
+         *
+         * Recommended values:
+         * - Serverless (Lambda, Cloud Functions): 1
+         * - Low traffic servers: 5-10
+         * - Medium traffic servers: 10-20
+         * - High traffic servers: 20-50
+         */
+        max?: number;
+        /**
+         * Idle timeout in seconds before a connection is closed.
+         * Defaults to 20 seconds.
+         */
+        idleTimeout?: number;
+    };
+    /**
+     * Nonce expiration time in seconds (defaults to 600 = 10 minutes)
+     */
+    nonceExpirationSeconds?: number;
+}
+//# sourceMappingURL=postgresStorageConfig.d.ts.map

package/dist/interfaces/postgresStorageConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresStorageConfig.d.ts","sourceRoot":"","sources":["../../src/interfaces/postgresStorageConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ;;;;;;;;;WASG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QACb;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC"}

package/dist/interfaces/postgresStorageConfig.js

@@ -0,0 +1 @@
+export {};

package/dist/postgresStorage.d.ts

@@ -0,0 +1,53 @@
+import { type LTIClient, type LTIDeployment, type LTIDynamicRegistrationSession, type LTILaunchConfig, type LTISession, type LTIStorage } from '@lti-tool/core';
+import type { PostgresStorageConfig } from './interfaces/postgresStorageConfig.js';
+/**
+ * PostgreSQL implementation of LTI storage interface.
+ *
+ * Stores clients, deployments, sessions, and nonces in PostgreSQL with LRU caching.
+ * Uses Drizzle ORM for type-safe database operations.
+ */
+export declare class PostgresStorage implements LTIStorage {
+    private logger;
+    private db;
+    private sql;
+    private nonceExpirationSeconds;
+    constructor(config: PostgresStorageConfig);
+    listClients(): Promise<Omit<LTIClient, 'deployments'>[]>;
+    getClientById(clientId: string): Promise<LTIClient | undefined>;
+    addClient(client: Omit<LTIClient, 'id'>): Promise<string>;
+    updateClient(clientId: string, client: Partial<Omit<LTIClient, 'id'>>): Promise<void>;
+    deleteClient(clientId: string): Promise<void>;
+    private updateClientLaunchConfigs;
+    listDeployments(clientId: string): Promise<LTIDeployment[]>;
+    getDeployment(clientId: string, deploymentId: string): Promise<LTIDeployment | undefined>;
+    addDeployment(clientId: string, deployment: Omit<LTIDeployment, 'id'>): Promise<string>;
+    updateDeployment(clientId: string, deploymentId: string, deployment: Partial<LTIDeployment>): Promise<void>;
+    deleteDeployment(clientId: string, deploymentId: string): Promise<void>;
+    storeNonce(nonce: string, expiresAt: Date): Promise<void>;
+    validateNonce(nonce: string): Promise<boolean>;
+    getSession(sessionId: string): Promise<LTISession | undefined>;
+    addSession(session: LTISession): Promise<string>;
+    getLaunchConfig(iss: string, clientId: string, deploymentId: string): Promise<LTILaunchConfig | undefined>;
+    saveLaunchConfig(launchConfig: LTILaunchConfig): Promise<void>;
+    setRegistrationSession(sessionId: string, session: LTIDynamicRegistrationSession): Promise<void>;
+    getRegistrationSession(sessionId: string): Promise<LTIDynamicRegistrationSession | undefined>;
+    deleteRegistrationSession(sessionId: string): Promise<void>;
+    /**
+     * Clean up expired nonces, sessions, and registration sessions.
+     * Should be called periodically (e.g., every 30 minutes via EventBridge).
+     *
+     * @returns Object with counts of deleted items
+     */
+    cleanup(): Promise<{
+        noncesDeleted: number;
+        sessionsDeleted: number;
+        registrationSessionsDeleted: number;
+    }>;
+    /**
+     * Close the PostgreSQL connection pool.
+     * Should be called on graceful server shutdown or after tests.
+     * Not required for serverless environments (Lambda manages lifecycle).
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=postgresStorage.d.ts.map

package/dist/postgresStorage.d.ts.map

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