@citadel-platform/platform 0.1.0

package/dist/app.d.ts

@@ -0,0 +1,5 @@
+export type { AppManifest, AppPackageDescriptor } from './appContract.js';
+export type { InstalledAppCatalogEntry } from './installedAppCatalogContract.js';
+export { DEFAULT_SPACE_ID, APP_ID_MAX_LENGTH, APP_ID_PATTERN, DISPLAY_NAME_MAX_LENGTH, GUEST_ID_MAX_LENGTH, GUEST_ID_PATTERN, SPACE_ID_MAX_LENGTH, SPACE_ID_PATTERN, isAppId, normalizeGuestId, normalizeSpaceId, type AppEventEnvelope, type AppId, type JoinSpacePayload, type Participant, type ParticipantEvent, type PlatformErrorPayload, type SpaceState } from './shared.js';
+export type { ValidationResult } from './validation.js';
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,KAAK,EACV,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/app.js

@@ -0,0 +1,2 @@
+export { DEFAULT_SPACE_ID, APP_ID_MAX_LENGTH, APP_ID_PATTERN, DISPLAY_NAME_MAX_LENGTH, GUEST_ID_MAX_LENGTH, GUEST_ID_PATTERN, SPACE_ID_MAX_LENGTH, SPACE_ID_PATTERN, isAppId, normalizeGuestId, normalizeSpaceId } from './shared.js';
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAQjB,MAAM,aAAa,CAAC"}

package/dist/appContract.d.ts

@@ -0,0 +1,22 @@
+import type { AppId } from './shared.js';
+export type AppManifest = {
+    appId: AppId;
+    label: string;
+    defaultSpaceId: string;
+    persistence: 'none' | 'sqlite';
+    version: string;
+};
+export type AppPackageDescriptor = {
+    appId: AppId;
+    manifest: AppManifest;
+    packageName: string;
+    client: {
+        subpath: './client';
+        registrationExport: string;
+    };
+    server: {
+        subpath: './server';
+        registrationExport: string;
+    };
+};
+//# sourceMappingURL=appContract.d.ts.map

package/dist/appContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appContract.d.ts","sourceRoot":"","sources":["../src/appContract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,OAAO,EAAE,UAAU,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,UAAU,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH,CAAC"}

package/dist/appContract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=appContract.js.map

package/dist/appContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appContract.js","sourceRoot":"","sources":["../src/appContract.ts"],"names":[],"mappings":""}

package/dist/appPackageMetadata.d.ts

@@ -0,0 +1,14 @@
+import type { AppPackageDescriptor } from './appContract.js';
+type PackageJson = {
+    name?: unknown;
+    citadel?: unknown;
+};
+type GenerateOptions = {
+    check?: boolean;
+    packageDirs?: string[];
+};
+export declare function parseAppPackageMetadata(packageName: string, packageJson: PackageJson): AppPackageDescriptor;
+export declare function generateAppMetadataSource(packageDir: string): string;
+export declare function generateAppMetadata(options?: GenerateOptions): void;
+export {};
+//# sourceMappingURL=appPackageMetadata.d.ts.map

package/dist/appPackageMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appPackageMetadata.d.ts","sourceRoot":"","sources":["../src/appPackageMetadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAK7D,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAIF,KAAK,eAAe,GAAG;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAqEF,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,oBAAoB,CA2B3G;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,UAqC3D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,eAAoB,QA2BhE"}

package/dist/appPackageMetadata.js

@@ -0,0 +1,126 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+const outputFileName = 'generatedMetadata.ts';
+const header = '// Generated by citadel-generate-app-metadata from package.json#citadel.\n';
+function literal(value) {
+    return JSON.stringify(value);
+}
+function readRequiredString(metadata, key, packageName) {
+    const value = metadata[key];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`App package ${packageName} citadel.${key} must be a non-empty string`);
+    }
+    return value;
+}
+function readPersistence(metadata, packageName) {
+    const value = readRequiredString(metadata, 'persistence', packageName);
+    if (value !== 'none' && value !== 'sqlite') {
+        throw new Error(`App package ${packageName} citadel.persistence must be "none" or "sqlite"`);
+    }
+    return value;
+}
+function readRegistrationMetadata(metadata, environment, packageName) {
+    const registration = metadata[environment];
+    if (!registration || typeof registration !== 'object' || Array.isArray(registration)) {
+        throw new Error(`App package ${packageName} citadel.${environment} must declare registration metadata`);
+    }
+    const registrationMetadata = registration;
+    const subpath = readRequiredString(registrationMetadata, 'subpath', packageName);
+    if (subpath !== './client' && subpath !== './server') {
+        throw new Error(`App package ${packageName} citadel.${environment}.subpath must be "./client" or "./server"`);
+    }
+    const registrationExport = readRequiredString(registrationMetadata, 'registrationExport', packageName);
+    if (environment === 'client') {
+        return {
+            subpath: './client',
+            registrationExport
+        };
+    }
+    return {
+        subpath: './server',
+        registrationExport
+    };
+}
+export function parseAppPackageMetadata(packageName, packageJson) {
+    if (packageJson.name !== packageName) {
+        throw new Error(`App package mismatch: expected ${packageName}, package.json declares ${String(packageJson.name)}`);
+    }
+    const metadata = packageJson.citadel;
+    if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata)) {
+        throw new Error(`App package ${packageName} must declare citadel metadata`);
+    }
+    const citadelMetadata = metadata;
+    const appId = readRequiredString(citadelMetadata, 'appId', packageName);
+    return {
+        appId,
+        manifest: {
+            appId,
+            label: readRequiredString(citadelMetadata, 'label', packageName),
+            defaultSpaceId: readRequiredString(citadelMetadata, 'defaultSpaceId', packageName),
+            persistence: readPersistence(citadelMetadata, packageName),
+            version: readRequiredString(citadelMetadata, 'version', packageName)
+        },
+        packageName,
+        client: readRegistrationMetadata(citadelMetadata, 'client', packageName),
+        server: readRegistrationMetadata(citadelMetadata, 'server', packageName)
+    };
+}
+export function generateAppMetadataSource(packageDir) {
+    const packageJson = JSON.parse(readFileSync(join(packageDir, 'package.json'), 'utf8'));
+    const packageName = packageJson.name;
+    if (typeof packageName !== 'string' || packageName.length === 0) {
+        throw new Error(`App package at ${packageDir} must declare package.json name`);
+    }
+    const descriptor = parseAppPackageMetadata(packageName, packageJson);
+    return [
+        header,
+        "import type { AppManifest, AppPackageDescriptor } from '@citadel-platform/platform/app';",
+        '',
+        'export const generatedManifest = {',
+        `  appId: ${literal(descriptor.manifest.appId)},`,
+        `  label: ${literal(descriptor.manifest.label)},`,
+        `  defaultSpaceId: ${literal(descriptor.manifest.defaultSpaceId)},`,
+        `  persistence: ${literal(descriptor.manifest.persistence)},`,
+        `  version: ${literal(descriptor.manifest.version)}`,
+        '} satisfies AppManifest;',
+        '',
+        'export const generatedAppPackage = {',
+        '  appId: generatedManifest.appId,',
+        '  manifest: generatedManifest,',
+        `  packageName: ${literal(descriptor.packageName)},`,
+        '  client: {',
+        `    subpath: ${literal(descriptor.client.subpath)},`,
+        `    registrationExport: ${literal(descriptor.client.registrationExport)}`,
+        '  },',
+        '  server: {',
+        `    subpath: ${literal(descriptor.server.subpath)},`,
+        `    registrationExport: ${literal(descriptor.server.registrationExport)}`,
+        '  }',
+        '} satisfies AppPackageDescriptor;',
+        ''
+    ].join('\n');
+}
+export function generateAppMetadata(options = {}) {
+    const packageDirs = options.packageDirs?.length ? options.packageDirs : [process.cwd()];
+    const staleFiles = [];
+    for (const packageDirInput of packageDirs) {
+        const packageDir = resolve(packageDirInput);
+        const outputPath = join(packageDir, 'src', outputFileName);
+        const expectedSource = generateAppMetadataSource(packageDir);
+        const currentSource = existsSync(outputPath) ? readFileSync(outputPath, 'utf8') : undefined;
+        if (options.check) {
+            if (currentSource !== expectedSource) {
+                staleFiles.push(outputPath);
+            }
+            continue;
+        }
+        writeFileSync(outputPath, expectedSource);
+    }
+    if (staleFiles.length > 0) {
+        throw new Error([
+            'Generated app metadata is stale. Run citadel-generate-app-metadata.',
+            ...staleFiles.map((filePath) => `- ${filePath}`)
+        ].join('\n'));
+    }
+}
+//# sourceMappingURL=appPackageMetadata.js.map

package/dist/appPackageMetadata.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,2 @@
+export type { AppViewProps, ClientAppModule, ClientAppRegistration } from './clientAppContract.js';
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,eAAe,EACf,qBAAqB,EACtB,MAAM,wBAAwB,CAAC"}

package/dist/client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":""}

package/dist/clientAppContract.d.ts

@@ -0,0 +1,21 @@
+import type { ComponentType } from 'react';
+import type { AppId, Participant } from './shared.js';
+export type AppViewProps<TState = unknown> = {
+    currentParticipant: Participant;
+    spaceId: string;
+    participants: Participant[];
+    appState: TState;
+    sendAppEvent(type: string, payload?: unknown): void;
+    setNotice(message: string): void;
+};
+export type ClientAppModule<TState = unknown> = {
+    appId: AppId;
+    label: string;
+    defaultSpaceId: string;
+    View: ComponentType<AppViewProps<TState>>;
+};
+export type ClientAppRegistration<TState = unknown> = {
+    appId: AppId;
+    clientApp: ClientAppModule<TState>;
+};
+//# sourceMappingURL=clientAppContract.d.ts.map

package/dist/clientAppContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientAppContract.d.ts","sourceRoot":"","sources":["../src/clientAppContract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,MAAM,YAAY,CAAC,MAAM,GAAG,OAAO,IAAI;IAC3C,kBAAkB,EAAE,WAAW,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACpD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,MAAM,GAAG,OAAO,IAAI;IAC9C,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,MAAM,GAAG,OAAO,IAAI;IACpD,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;CACpC,CAAC"}

package/dist/clientAppContract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=clientAppContract.js.map

package/dist/clientAppContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientAppContract.js","sourceRoot":"","sources":["../src/clientAppContract.ts"],"names":[],"mappings":""}

package/dist/generateAppMetadataCli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=generateAppMetadataCli.d.ts.map

package/dist/generateAppMetadataCli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateAppMetadataCli.d.ts","sourceRoot":"","sources":["../src/generateAppMetadataCli.ts"],"names":[],"mappings":""}

package/dist/generateAppMetadataCli.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { generateAppMetadata } from './appPackageMetadata.js';
+function usage() {
+    return [
+        'Usage: citadel-generate-app-metadata [--check] [--package-dir <dir>]',
+        '',
+        'Generates app runtime metadata source from package.json#citadel.'
+    ].join('\n');
+}
+function parseArgs(argv) {
+    const packageDirs = [];
+    let check = false;
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === '--check') {
+            check = true;
+            continue;
+        }
+        if (token === '--package-dir') {
+            const packageDir = argv[index + 1];
+            if (!packageDir) {
+                throw new Error(`${usage()}\n\n--package-dir requires a value`);
+            }
+            packageDirs.push(packageDir);
+            index += 1;
+            continue;
+        }
+        throw new Error(`${usage()}\n\nUnknown option: ${token}`);
+    }
+    return {
+        check,
+        packageDirs
+    };
+}
+try {
+    generateAppMetadata(parseArgs(process.argv.slice(2)));
+}
+catch (error) {
+    console.error(error instanceof Error ? error.message : error);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=generateAppMetadataCli.js.map

package/dist/generateAppMetadataCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateAppMetadataCli.js","sourceRoot":"","sources":["../src/generateAppMetadataCli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,SAAS,KAAK;IACZ,OAAO;QACL,sEAAsE;QACtE,EAAE;QACF,kEAAkE;KACnE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,KAAK,GAAG,KAAK,CAAC;IAElB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAE1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,GAAG,IAAI,CAAC;YACb,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAEnC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,EAAE,oCAAoC,CAAC,CAAC;YAClE,CAAC;YAED,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,EAAE,uBAAuB,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO;QACL,KAAK;QACL,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,IAAI,CAAC;IACH,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/installedAppCatalogContract.d.ts

@@ -0,0 +1,9 @@
+import type { AppPackageDescriptor } from './appContract.js';
+import type { ClientAppRegistration } from './clientAppContract.js';
+import type { ServerAppRegistration } from './serverAppContract.js';
+export type InstalledAppCatalogEntry<TState = any, TServices = any> = {
+    descriptor: AppPackageDescriptor;
+    clientRegistration: ClientAppRegistration<TState>;
+    serverRegistration: ServerAppRegistration<TServices>;
+};
+//# sourceMappingURL=installedAppCatalogContract.d.ts.map

package/dist/installedAppCatalogContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installedAppCatalogContract.d.ts","sourceRoot":"","sources":["../src/installedAppCatalogContract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,MAAM,MAAM,wBAAwB,CAClC,MAAM,GAAG,GAAG,EACZ,SAAS,GAAG,GAAG,IACb;IACF,UAAU,EAAE,oBAAoB,CAAC;IACjC,kBAAkB,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAClD,kBAAkB,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;CACtD,CAAC"}

package/dist/installedAppCatalogContract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=installedAppCatalogContract.js.map

package/dist/installedAppCatalogContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installedAppCatalogContract.js","sourceRoot":"","sources":["../src/installedAppCatalogContract.ts"],"names":[],"mappings":""}

package/dist/persistence.d.ts

@@ -0,0 +1,2 @@
+export { openCitadelDatabase, type CitadelDatabase } from './sqlite.js';
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/persistence.js

@@ -0,0 +1,2 @@
+export { openCitadelDatabase } from './sqlite.js';
+//# sourceMappingURL=persistence.js.map

package/dist/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAwB,MAAM,aAAa,CAAC"}

package/dist/server-app.d.ts

@@ -0,0 +1,2 @@
+export * from './serverApp.js';
+//# sourceMappingURL=server-app.d.ts.map

package/dist/server-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-app.d.ts","sourceRoot":"","sources":["../src/server-app.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/server-app.js

@@ -0,0 +1,2 @@
+export * from './serverApp.js';
+//# sourceMappingURL=server-app.js.map

package/dist/server-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-app.js","sourceRoot":"","sources":["../src/server-app.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+import { Server } from 'socket.io';
+import type { AppManifest } from './appContract.js';
+import type { ServerAppModule } from './serverAppContract.js';
+export type PlatformServerOptions = {
+    clientOrigin?: string;
+    staticDir?: string;
+    apps: ServerAppModule[];
+    appManifests?: AppManifest[];
+};
+export declare function createPlatformServer(options: PlatformServerOptions): {
+    app: import("express-serve-static-core").Express;
+    httpServer: import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>;
+    io: Server<import("socket.io").DefaultEventsMap, import("socket.io").DefaultEventsMap, import("socket.io").DefaultEventsMap, any>;
+    apps: Map<string, ServerAppModule>;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAe,MAAM,WAAW,CAAC;AAYhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIhF,MAAM,MAAM,qBAAqB,GAAG;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9B,CAAC;AAeF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB;;;;;EA2RlE"}

package/dist/server.js

@@ -0,0 +1,249 @@
+import express from 'express';
+import { createServer } from 'node:http';
+import { join } from 'node:path';
+import { nanoid } from 'nanoid';
+import { Server } from 'socket.io';
+import { DEFAULT_SPACE_ID, isAppId, normalizeGuestId, normalizeSpaceId } from './shared.js';
+import { validateDisplayName } from './validation.js';
+import { PLATFORM_VERSION } from './version.js';
+export function createPlatformServer(options) {
+    const clientOrigin = options.clientOrigin ?? 'http://localhost:5173';
+    const app = express();
+    const httpServer = createServer(app);
+    const io = new Server(httpServer, {
+        cors: {
+            origin: clientOrigin,
+            methods: ['GET', 'POST']
+        }
+    });
+    const modules = new Map();
+    const manifests = new Map();
+    const sessions = new Map();
+    const appState = new Map();
+    const defaultAppId = options.apps[0]?.appId;
+    for (const module of options.apps) {
+        modules.set(module.appId, module);
+    }
+    for (const manifest of options.appManifests ?? []) {
+        if (modules.has(manifest.appId)) {
+            manifests.set(manifest.appId, manifest);
+        }
+    }
+    function spaceKey(appId, spaceId) {
+        return `${appId}:${spaceId}`;
+    }
+    function socketRoom(appId, spaceId) {
+        return `space:${spaceKey(appId, spaceId)}`;
+    }
+    function getParticipants(appId, spaceId) {
+        return [...sessions.values()]
+            .filter((session) => session.appId === appId && session.spaceId === spaceId)
+            .map((session) => session.participant)
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    function makeContext(socket, session) {
+        const key = spaceKey(session.appId, session.spaceId);
+        const module = modules.get(session.appId);
+        if (!module) {
+            throw new Error(`Unknown app module: ${session.appId}`);
+        }
+        return {
+            appId: session.appId,
+            spaceId: session.spaceId,
+            socketId: socket.id,
+            participant: session.participant,
+            participants: getParticipants(session.appId, session.spaceId),
+            emitToSpace(type, payload) {
+                io.to(socketRoom(session.appId, session.spaceId)).emit('app:event', {
+                    appId: session.appId,
+                    type,
+                    payload
+                });
+            },
+            emitToParticipant(type, payload) {
+                socket.emit('app:event', {
+                    appId: session.appId,
+                    type,
+                    payload
+                });
+            },
+            emitSpaceState() {
+                emitSpaceState(session.appId, session.spaceId);
+            },
+            getAppState() {
+                return appState.get(key);
+            },
+            setAppState(state) {
+                appState.set(key, state);
+            },
+            clearAppState() {
+                appState.delete(key);
+            }
+        };
+    }
+    function getSpaceState(appId, spaceId) {
+        const module = modules.get(appId);
+        if (!module) {
+            return { appId, spaceId, participants: [], appState: null };
+        }
+        const key = spaceKey(appId, spaceId);
+        const baseContext = {
+            appId,
+            spaceId,
+            participants: getParticipants(appId, spaceId),
+            emitToSpace(type, payload) {
+                io.to(socketRoom(appId, spaceId)).emit('app:event', { appId, type, payload });
+            },
+            emitToParticipant() { },
+            emitSpaceState() {
+                emitSpaceState(appId, spaceId);
+            },
+            getAppState() {
+                return appState.get(key);
+            },
+            setAppState(state) {
+                appState.set(key, state);
+            },
+            clearAppState() {
+                appState.delete(key);
+            }
+        };
+        return {
+            appId,
+            spaceId,
+            participants: baseContext.participants,
+            appState: module.getInitialState(baseContext)
+        };
+    }
+    function emitSpaceState(appId, spaceId) {
+        io.to(socketRoom(appId, spaceId)).emit('space:state', getSpaceState(appId, spaceId));
+    }
+    function leaveCurrentSpace(socket, notifyParticipant = true) {
+        const session = sessions.get(socket.id);
+        if (!session) {
+            return;
+        }
+        const module = modules.get(session.appId);
+        sessions.delete(socket.id);
+        const context = makeContext(socket, session);
+        module?.onParticipantLeft?.(context);
+        socket.leave(socketRoom(session.appId, session.spaceId));
+        if (notifyParticipant) {
+            socket.to(socketRoom(session.appId, session.spaceId)).emit('participant:left', {
+                id: nanoid(),
+                type: 'participant:left',
+                appId: session.appId,
+                spaceId: session.spaceId,
+                participant: session.participant,
+                createdAt: new Date().toISOString()
+            });
+        }
+        if (getParticipants(session.appId, session.spaceId).length === 0) {
+            appState.delete(spaceKey(session.appId, session.spaceId));
+        }
+        emitSpaceState(session.appId, session.spaceId);
+    }
+    function getPlatformMetadata() {
+        const apps = [...modules.keys()];
+        return {
+            apps,
+            appCount: apps.length,
+            appManifests: apps
+                .map((appId) => manifests.get(appId))
+                .filter((manifest) => Boolean(manifest)),
+            version: PLATFORM_VERSION
+        };
+    }
+    app.get('/health', (_request, response) => {
+        response.json({
+            ...getPlatformMetadata(),
+            ok: true,
+            participants: sessions.size
+        });
+    });
+    app.get('/config', (_request, response) => {
+        const { apps, appManifests } = getPlatformMetadata();
+        response.json({
+            apps,
+            appManifests
+        });
+    });
+    if (options.staticDir) {
+        const indexPath = join(options.staticDir, 'index.html');
+        app.use(express.static(options.staticDir, { index: false }));
+        app.get(/.*/, (_request, response) => {
+            response.sendFile(indexPath);
+        });
+    }
+    io.on('connection', (socket) => {
+        socket.on('space:join', (payload = { appId: defaultAppId ?? '', name: '' }) => {
+            const appId = isAppId(payload.appId) ? payload.appId : defaultAppId;
+            if (!appId) {
+                socket.emit('error:notice', { message: 'Unknown app.' });
+                return;
+            }
+            const module = modules.get(appId);
+            if (!module) {
+                socket.emit('error:notice', { message: 'Unknown app.' });
+                return;
+            }
+            const result = validateDisplayName(payload.name);
+            const spaceId = normalizeSpaceId(payload.spaceId ?? DEFAULT_SPACE_ID);
+            if (!result.ok) {
+                socket.emit('error:notice', { message: result.error });
+                return;
+            }
+            const previousSession = sessions.get(socket.id);
+            const previousKey = previousSession
+                ? spaceKey(previousSession.appId, previousSession.spaceId)
+                : null;
+            const nextKey = spaceKey(appId, spaceId);
+            if (previousSession && previousKey !== nextKey) {
+                leaveCurrentSpace(socket);
+            }
+            const participant = {
+                id: normalizeGuestId(payload.guestId, socket.id),
+                socketId: socket.id,
+                name: result.value
+            };
+            const session = { appId, spaceId, participant };
+            sessions.set(socket.id, session);
+            socket.join(socketRoom(appId, spaceId));
+            if (!previousSession || previousKey !== nextKey) {
+                socket.to(socketRoom(appId, spaceId)).emit('participant:joined', {
+                    id: nanoid(),
+                    type: 'participant:joined',
+                    appId,
+                    spaceId,
+                    participant,
+                    createdAt: new Date().toISOString()
+                });
+            }
+            module.onParticipantJoined?.(makeContext(socket, session));
+            emitSpaceState(appId, spaceId);
+        });
+        socket.on('app:event', (event) => {
+            const session = sessions.get(socket.id);
+            if (!session) {
+                socket.emit('error:notice', { message: 'Join a space before sending events.' });
+                return;
+            }
+            if (!event || event.appId !== session.appId) {
+                socket.emit('error:notice', { message: 'Event app does not match the current space.' });
+                return;
+            }
+            const module = modules.get(session.appId);
+            module?.handleEvent(makeContext(socket, session), event);
+        });
+        socket.on('disconnect', () => {
+            leaveCurrentSpace(socket);
+        });
+    });
+    return {
+        app,
+        httpServer,
+        io,
+        apps: modules
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/serverApp.d.ts

@@ -0,0 +1,6 @@
+import type { CitadelDatabase } from './persistence.js';
+export type { ServerAppBundle, ServerAppContext, ServerAppModule, ServerAppRegistration } from './serverAppContract.js';
+export type ServerAppServices = {
+    database: CitadelDatabase;
+};
+//# sourceMappingURL=serverApp.d.ts.map

package/dist/serverApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverApp.d.ts","sourceRoot":"","sources":["../src/serverApp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC"}

package/dist/serverApp.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=serverApp.js.map

package/dist/serverApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverApp.js","sourceRoot":"","sources":["../src/serverApp.ts"],"names":[],"mappings":""}

package/dist/serverAppContract.d.ts

@@ -0,0 +1,31 @@
+import type { AppEventEnvelope, AppId, Participant } from './shared.js';
+export type ServerAppContext = {
+    appId: AppId;
+    spaceId: string;
+    socketId: string;
+    participant: Participant;
+    participants: Participant[];
+    emitToSpace(type: string, payload?: unknown): void;
+    emitToParticipant(type: string, payload?: unknown): void;
+    emitSpaceState(): void;
+    getAppState<T>(): T | undefined;
+    setAppState<T>(state: T): void;
+    clearAppState(): void;
+};
+export type ServerAppModule = {
+    appId: AppId;
+    getInitialState(context: Omit<ServerAppContext, 'participant' | 'socketId'>): unknown;
+    handleEvent(context: ServerAppContext, event: AppEventEnvelope): void;
+    onParticipantJoined?(context: ServerAppContext): void;
+    onParticipantLeft?(context: ServerAppContext): void;
+};
+export type ServerAppBundle<TServices> = {
+    appId: AppId;
+    createServerApp(services: TServices): ServerAppModule;
+};
+export type ServerAppRegistration<TServices> = {
+    appId: AppId;
+    bundle: ServerAppBundle<TServices>;
+    createServerApp(services: TServices): ServerAppModule;
+};
+//# sourceMappingURL=serverAppContract.d.ts.map

package/dist/serverAppContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverAppContract.d.ts","sourceRoot":"","sources":["../src/serverAppContract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACnD,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzD,cAAc,IAAI,IAAI,CAAC;IACvB,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC/B,aAAa,IAAI,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC;IACtF,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACtE,mBAAmB,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACtD,iBAAiB,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,SAAS,IAAI;IACvC,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,CAAC,QAAQ,EAAE,SAAS,GAAG,eAAe,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,SAAS,IAAI;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACnC,eAAe,CAAC,QAAQ,EAAE,SAAS,GAAG,eAAe,CAAC;CACvD,CAAC"}

package/dist/serverAppContract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=serverAppContract.js.map

package/dist/serverAppContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverAppContract.js","sourceRoot":"","sources":["../src/serverAppContract.ts"],"names":[],"mappings":""}

package/dist/shared.d.ts

@@ -0,0 +1,46 @@
+export declare const DISPLAY_NAME_MAX_LENGTH = 24;
+export declare const DEFAULT_SPACE_ID = "general";
+export declare const SPACE_ID_MAX_LENGTH = 32;
+export declare const SPACE_ID_PATTERN: RegExp;
+export declare const GUEST_ID_MAX_LENGTH = 80;
+export declare const GUEST_ID_PATTERN: RegExp;
+export declare const APP_ID_MAX_LENGTH = 64;
+export declare const APP_ID_PATTERN: RegExp;
+export type AppId = string;
+export type Participant = {
+    id: string;
+    socketId?: string;
+    name: string;
+};
+export type SpaceState<TAppState = unknown> = {
+    appId: AppId;
+    spaceId: string;
+    participants: Participant[];
+    appState: TAppState;
+};
+export type JoinSpacePayload = {
+    appId: AppId;
+    spaceId?: string;
+    guestId?: string;
+    name: string;
+};
+export type PlatformErrorPayload = {
+    message: string;
+};
+export type ParticipantEvent = {
+    id: string;
+    type: 'participant:joined' | 'participant:left';
+    appId: AppId;
+    spaceId: string;
+    participant: Participant;
+    createdAt: string;
+};
+export type AppEventEnvelope<TPayload = unknown> = {
+    appId: AppId;
+    type: string;
+    payload?: TPayload;
+};
+export declare function normalizeSpaceId(input: unknown): string;
+export declare function isAppId(value: unknown): value is AppId;
+export declare function normalizeGuestId(input: unknown, fallback: string): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,gBAAgB,QAAiB,CAAC;AAC/C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,gBAAgB,QAAqB,CAAC;AACnD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,cAAc,QAAiB,CAAC;AAE7C,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,SAAS,GAAG,OAAO,IAAI;IAC5C,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,CAAC;IAChD,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,QAAQ,GAAG,OAAO,IAAI;IACjD,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYvD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAOtD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYzE"}

package/dist/shared.js

@@ -0,0 +1,35 @@
+export const DISPLAY_NAME_MAX_LENGTH = 24;
+export const DEFAULT_SPACE_ID = 'general';
+export const SPACE_ID_MAX_LENGTH = 32;
+export const SPACE_ID_PATTERN = /^[a-z0-9-]+$/;
+export const GUEST_ID_MAX_LENGTH = 80;
+export const GUEST_ID_PATTERN = /^[A-Za-z0-9_-]+$/;
+export const APP_ID_MAX_LENGTH = 64;
+export const APP_ID_PATTERN = /^[a-z0-9-]+$/;
+export function normalizeSpaceId(input) {
+    if (typeof input !== 'string') {
+        return DEFAULT_SPACE_ID;
+    }
+    const value = input.trim().toLowerCase();
+    if (!value || value.length > SPACE_ID_MAX_LENGTH || !SPACE_ID_PATTERN.test(value)) {
+        return DEFAULT_SPACE_ID;
+    }
+    return value;
+}
+export function isAppId(value) {
+    return (typeof value === 'string' &&
+        value.length > 0 &&
+        value.length <= APP_ID_MAX_LENGTH &&
+        APP_ID_PATTERN.test(value));
+}
+export function normalizeGuestId(input, fallback) {
+    if (typeof input !== 'string') {
+        return fallback;
+    }
+    const value = input.trim();
+    if (!value || value.length > GUEST_ID_MAX_LENGTH || !GUEST_ID_PATTERN.test(value)) {
+        return fallback;
+    }
+    return value;
+}
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAC1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC;AA2C7C,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEzC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,mBAAmB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClF,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,KAAK,CAAC,MAAM,IAAI,iBAAiB;QACjC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,QAAgB;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE3B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,mBAAmB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/sqlite.d.ts

@@ -0,0 +1,7 @@
+import { DatabaseSync } from 'node:sqlite';
+export type CitadelDatabase = {
+    database: DatabaseSync;
+    close(): void;
+};
+export declare function openCitadelDatabase(dbPath: string): CitadelDatabase;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAanE"}

package/dist/sqlite.js

@@ -0,0 +1,16 @@
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+export function openCitadelDatabase(dbPath) {
+    if (dbPath !== ':memory:') {
+        mkdirSync(dirname(dbPath), { recursive: true });
+    }
+    const database = new DatabaseSync(dbPath);
+    return {
+        database,
+        close() {
+            database.close();
+        }
+    };
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAE1C,OAAO;QACL,QAAQ;QACR,KAAK;YACH,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,9 @@
+export type ValidationResult = {
+    ok: true;
+    value: string;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateDisplayName(input: unknown): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAmBpE"}

package/dist/validation.js

@@ -0,0 +1,18 @@
+import { DISPLAY_NAME_MAX_LENGTH } from './shared.js';
+export function validateDisplayName(input) {
+    if (typeof input !== 'string') {
+        return { ok: false, error: 'Enter a display name.' };
+    }
+    const value = input.trim().replace(/\s+/g, ' ');
+    if (!value) {
+        return { ok: false, error: 'Enter a display name.' };
+    }
+    if (value.length > DISPLAY_NAME_MAX_LENGTH) {
+        return {
+            ok: false,
+            error: `Display names must be ${DISPLAY_NAME_MAX_LENGTH} characters or fewer.`
+        };
+    }
+    return { ok: true, value };
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAMtD,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEhD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,uBAAuB,EAAE,CAAC;QAC3C,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,yBAAyB,uBAAuB,uBAAuB;SAC/E,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const PLATFORM_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const PLATFORM_VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@citadel-platform/platform",
+  "version": "0.1.0",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "citadel-generate-app-metadata": "dist/generateAppMetadataCli.js"
+  },
+  "exports": {
+    "./app": {
+      "types": "./dist/app.d.ts",
+      "import": "./dist/app.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./server-app": {
+      "types": "./dist/server-app.d.ts",
+      "import": "./dist/server-app.js"
+    },
+    "./persistence": {
+      "types": "./dist/persistence.d.ts",
+      "import": "./dist/persistence.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./validation": {
+      "types": "./dist/validation.d.ts",
+      "import": "./dist/validation.js"
+    }
+  },
+  "scripts": {
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
+    "clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run tests"
+  },
+  "dependencies": {
+    "express": "^5.1.0",
+    "nanoid": "^5.1.5",
+    "socket.io": "^4.8.1"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.9"
+  },
+  "peerDependencies": {
+    "react": "^19.1.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  }
+}