@playdrop/playdrop-cli 0.7.0 → 0.7.1

package/node_modules/@playdrop/config/dist/src/public-deployment.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDeployRole = parseDeployRole;
+exports.parseDeploySlot = parseDeploySlot;
+exports.parsePublicSurface = parsePublicSurface;
+exports.resolveDeployRole = resolveDeployRole;
+exports.resolveDeploySlot = resolveDeploySlot;
+exports.resolvePublicSurface = resolvePublicSurface;
+exports.resolveEnvironmentName = resolveEnvironmentName;
+exports.resolveSeoIndexingMode = resolveSeoIndexingMode;
+exports.resolveWebOrigin = resolveWebOrigin;
+exports.resolveApiOrigin = resolveApiOrigin;
+exports.resolveRealtimeOrigin = resolveRealtimeOrigin;
+exports.resolveAiOrigin = resolveAiOrigin;
+exports.resolveStructuredLogFields = resolveStructuredLogFields;
+const DEPLOY_ROLE_VALUES = new Set(['prod', 'preview']);
+const DEPLOY_SLOT_VALUES = new Set(['blue', 'green']);
+const PUBLIC_SURFACE_VALUES = new Set(['prod', 'preview', 'blue', 'green']);
+function normalizeValue(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const normalized = value.trim().toLowerCase();
+    return normalized.length > 0 ? normalized : null;
+}
+function normalizeOrigin(value) {
+    return value.trim().replace(/\/+$/, '');
+}
+function buildDefaultOrigin(params) {
+    const { servicePrefix, surface, websocket = false } = params;
+    const protocol = websocket ? 'wss' : 'https';
+    const host = surface === 'prod'
+        ? servicePrefix ? `${servicePrefix}.playdrop.ai` : 'www.playdrop.ai'
+        : servicePrefix
+            ? `${servicePrefix}.${surface}.playdrop.ai`
+            : `${surface}.playdrop.ai`;
+    return `${protocol}://${host}`;
+}
+function parseReleaseBuild(value) {
+    const parsed = Number(value);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : 0;
+}
+function parseDeployRole(value) {
+    const normalized = normalizeValue(value);
+    if (!normalized || !DEPLOY_ROLE_VALUES.has(normalized)) {
+        return null;
+    }
+    return normalized;
+}
+function parseDeploySlot(value) {
+    const normalized = normalizeValue(value);
+    if (!normalized || !DEPLOY_SLOT_VALUES.has(normalized)) {
+        return null;
+    }
+    return normalized;
+}
+function parsePublicSurface(value) {
+    const normalized = normalizeValue(value);
+    if (!normalized || !PUBLIC_SURFACE_VALUES.has(normalized)) {
+        return null;
+    }
+    return normalized;
+}
+function resolveDeployRole(env = process.env) {
+    return parseDeployRole(env['PLAYDROP_DEPLOY_ROLE'])
+        ?? (env['NODE_ENV'] === 'production' ? 'prod' : 'preview');
+}
+function resolveDeploySlot(env = process.env) {
+    return parseDeploySlot(env['PLAYDROP_SLOT']);
+}
+function resolvePublicSurface(env = process.env) {
+    const explicit = parsePublicSurface(env['PLAYDROP_PUBLIC_SURFACE']);
+    if (explicit) {
+        return explicit;
+    }
+    return resolveDeployRole(env) === 'preview' ? 'preview' : 'prod';
+}
+function resolveEnvironmentName(env = process.env) {
+    const explicit = typeof env['PLAYDROP_ENVIRONMENT'] === 'string' ? env['PLAYDROP_ENVIRONMENT'].trim() : '';
+    if (explicit.length > 0) {
+        return explicit;
+    }
+    const nodeEnv = typeof env['NODE_ENV'] === 'string' ? env['NODE_ENV'].trim() : '';
+    return nodeEnv.length > 0 ? nodeEnv : 'development';
+}
+function resolveSeoIndexingMode(env = process.env) {
+    const explicit = normalizeValue(env['PLAYDROP_SEO_INDEXING']);
+    if (explicit === 'public') {
+        return 'public';
+    }
+    if (explicit === 'private') {
+        return 'private';
+    }
+    if (explicit === 'noindex') {
+        return 'noindex';
+    }
+    return resolveDeployRole(env) === 'prod' ? 'public' : 'noindex';
+}
+function resolveWebOrigin(env = process.env) {
+    const explicit = typeof env['PLAYDROP_PUBLIC_ORIGIN'] === 'string' ? env['PLAYDROP_PUBLIC_ORIGIN'].trim() : '';
+    if (explicit.length > 0) {
+        return normalizeOrigin(explicit);
+    }
+    const legacy = typeof env['PLAYDROP_WEB_BASE_URL'] === 'string' ? env['PLAYDROP_WEB_BASE_URL'].trim() : '';
+    if (legacy.length > 0) {
+        return normalizeOrigin(legacy);
+    }
+    return buildDefaultOrigin({ surface: resolvePublicSurface(env) });
+}
+function resolveApiOrigin(env = process.env) {
+    const explicit = typeof env['PLAYDROP_API_BASE_URL'] === 'string' ? env['PLAYDROP_API_BASE_URL'].trim() : '';
+    if (explicit.length > 0) {
+        return normalizeOrigin(explicit);
+    }
+    return buildDefaultOrigin({ servicePrefix: 'api', surface: resolvePublicSurface(env) });
+}
+function resolveRealtimeOrigin(env = process.env) {
+    const explicit = typeof env['PLAYDROP_REALTIME_BASE_URL'] === 'string' ? env['PLAYDROP_REALTIME_BASE_URL'].trim() : '';
+    if (explicit.length > 0) {
+        return normalizeOrigin(explicit);
+    }
+    return buildDefaultOrigin({ servicePrefix: 'play', surface: resolvePublicSurface(env), websocket: true });
+}
+function resolveAiOrigin(env = process.env) {
+    const explicit = typeof env['PLAYDROP_AI_BASE_URL'] === 'string' ? env['PLAYDROP_AI_BASE_URL'].trim() : '';
+    if (explicit.length > 0) {
+        return normalizeOrigin(explicit);
+    }
+    return buildDefaultOrigin({ servicePrefix: 'ai', surface: resolvePublicSurface(env) });
+}
+function resolveStructuredLogFields(service, env = process.env) {
+    const releaseVersion = typeof env['PLAYDROP_RELEASE_VERSION'] === 'string' && env['PLAYDROP_RELEASE_VERSION'].trim().length > 0
+        ? env['PLAYDROP_RELEASE_VERSION'].trim()
+        : typeof env['NEXT_PUBLIC_PLAYDROP_RELEASE_VERSION'] === 'string' && env['NEXT_PUBLIC_PLAYDROP_RELEASE_VERSION'].trim().length > 0
+            ? env['NEXT_PUBLIC_PLAYDROP_RELEASE_VERSION'].trim()
+            : '0.0.0';
+    const buildNumber = parseReleaseBuild(env['PLAYDROP_BUILD_NUMBER'] ?? env['NEXT_PUBLIC_PLAYDROP_BUILD_NUMBER']);
+    const slot = resolveDeploySlot(env);
+    return {
+        environment: resolveEnvironmentName(env),
+        slot: slot ?? 'none',
+        service,
+        release_version: releaseVersion,
+        build_number: buildNumber,
+        deploy_role: resolveDeployRole(env),
+        public_surface: resolvePublicSurface(env),
+    };
+}

package/node_modules/@playdrop/config/dist/src/server/fastify.d.ts

@@ -1,10 +1,69 @@
-import type { FastifyRequest } from 'fastify';
+import { Writable } from 'node:stream';
+import type { FastifyInstance, FastifyLoggerOptions, FastifyReply, FastifyRequest, FastifyServerOptions, RawServerDefault } from 'fastify';
 import type { ClientErrorResponseBody, ClientRuntimeInfo, ClientValidator, ClientValidationFailure, ClientGuard, NormalizedClientRuntimeInfo } from '../types';
 declare module 'fastify' {
     interface FastifyRequest {
         clientRuntime?: NormalizedClientRuntimeInfo;
+        requestLogContext?: {
+            userId?: string;
+            roomId?: string;
+        };
     }
 }
+export declare function setRequestLogContext(request: FastifyRequest, input: {
+    userId?: string | number | null;
+    roomId?: string | number | null;
+}): void;
+export declare function buildFastifyLogger(service: string): (FastifyLoggerOptions<RawServerDefault, FastifyRequest<import("fastify").RouteGenericInterface, RawServerDefault, import("http").IncomingMessage, import("fastify").FastifySchema, import("fastify").FastifyTypeProviderDefault, unknown, import("fastify").FastifyBaseLogger, import("fastify/types/type-provider").ResolveFastifyRequestType<import("fastify").FastifyTypeProviderDefault, import("fastify").FastifySchema, import("fastify").RouteGenericInterface>>, FastifyReply<import("fastify").RouteGenericInterface, RawServerDefault, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, unknown, import("fastify").FastifySchema, import("fastify").FastifyTypeProviderDefault, unknown>> & {
+    base: Record<string, unknown>;
+    messageKey: string;
+    formatters: {
+        level(label: string): {
+            level: string;
+        };
+    };
+    timestamp: () => string;
+    stream?: Writable;
+}) | {
+    stream: Writable;
+    serializers?: {
+        req?: (req: FastifyRequest<import("fastify").RouteGenericInterface, RawServerDefault, import("http").IncomingMessage, import("fastify").FastifySchema, import("fastify").FastifyTypeProviderDefault, unknown, import("fastify").FastifyBaseLogger, import("fastify/types/type-provider").ResolveFastifyRequestType<import("fastify").FastifyTypeProviderDefault, import("fastify").FastifySchema, import("fastify").RouteGenericInterface>>) => {
+            method?: string;
+            url?: string;
+            version?: string;
+            host?: string;
+            remoteAddress?: string;
+            remotePort?: number;
+            [key: string]: unknown;
+        };
+        err?: (err: import("fastify").FastifyError) => {
+            type: string;
+            message: string;
+            stack: string;
+            [key: string]: unknown;
+        };
+        res?: (res: import("fastify/types/logger").ResSerializerReply<RawServerDefault, FastifyReply<import("fastify").RouteGenericInterface, RawServerDefault, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, unknown, import("fastify").FastifySchema, import("fastify").FastifyTypeProviderDefault, unknown>>) => {
+            statusCode?: string | number;
+            [key: string]: unknown;
+        };
+    };
+    level?: string;
+    file?: string;
+    genReqId?: (req: FastifyRequest<import("fastify").RouteGenericInterface, RawServerDefault, import("http").IncomingMessage, import("fastify").FastifySchema, import("fastify").FastifyTypeProviderDefault, unknown, import("fastify").FastifyBaseLogger, import("fastify/types/type-provider").ResolveFastifyRequestType<import("fastify").FastifyTypeProviderDefault, import("fastify").FastifySchema, import("fastify").RouteGenericInterface>>) => string;
+    base: Record<string, unknown>;
+    messageKey: string;
+    formatters: {
+        level(label: string): {
+            level: string;
+        };
+    };
+    timestamp: () => string;
+};
+export declare function buildFastifyServerOptions(params: {
+    service: string;
+    bodyLimit?: number;
+}): FastifyServerOptions<RawServerDefault>;
+export declare function registerStructuredRequestLogging(app: FastifyInstance): void;
 export declare function readClientHeaders(request: FastifyRequest): ClientRuntimeInfo;
 export declare function formatClientError(failure: ClientValidationFailure): ClientErrorResponseBody;
 export declare function buildClientGuard(reader?: (request: FastifyRequest) => ClientRuntimeInfo, validator?: ClientValidator, formatter?: (failure: ClientValidationFailure) => ClientErrorResponseBody): ClientGuard;

package/node_modules/@playdrop/config/dist/src/server/fastify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../../../src/server/fastify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,SAAS,CAAC;AAM5D,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAElB,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,cAAc;QACtB,aAAa,CAAC,EAAE,2BAA2B,CAAC;KAC7C;CACF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB,CAiB5E;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,uBAAuB,GAC/B,uBAAuB,CAkEzB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,GAAE,CAAC,OAAO,EAAE,cAAc,KAAK,iBAAqC,EAC1E,SAAS,GAAE,eAA2C,EACtD,SAAS,GAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,uBAA2C,GAC3F,WAAW,CAkBb;AAED,eAAO,MAAM,qBAAqB,aAAqB,CAAC"}
+{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../../../src/server/fastify.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,oBAAoB,EAEpB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAQjB,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAElB,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,cAAc;QACtB,aAAa,CAAC,EAAE,2BAA2B,CAAC;QAC5C,iBAAiB,CAAC,EAAE;YAClB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;KACH;CACF;AAUD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE;IACL,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACjC,GACA,IAAI,CAUN;AAgBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM;UAYxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACjB,MAAM;gBACN;QACV,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG;YACpB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH;eACU,MAAM,MAAM;aACd,QAAQ;;;;;kBATiB,CAAC;eAAoB,CAAA;mBACtC,CAAC;gBACf,CAAC;yBACK,CAAC;sBACQ,CAAC;;;;;;;;;;sBAaG,CAAC;;;;;;;UAhBjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACjB,MAAM;gBACN;QACV,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG;YACpB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH;eACU,MAAM,MAAM;EAW1B;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,oBAAoB,CAAC,gBAAgB,CAAC,CAiBzC;AAED,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAsC3E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB,CAiB5E;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,uBAAuB,GAC/B,uBAAuB,CAkEzB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,GAAE,CAAC,OAAO,EAAE,cAAc,KAAK,iBAAqC,EAC1E,SAAS,GAAE,eAA2C,EACtD,SAAS,GAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,uBAA2C,GAC3F,WAAW,CAkBb;AAED,eAAO,MAAM,qBAAqB,aAAqB,CAAC"}

package/node_modules/@playdrop/config/dist/src/server/fastify.js

@@ -1,10 +1,129 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureSupportedClient = void 0;
+exports.setRequestLogContext = setRequestLogContext;
+exports.buildFastifyLogger = buildFastifyLogger;
+exports.buildFastifyServerOptions = buildFastifyServerOptions;
+exports.registerStructuredRequestLogging = registerStructuredRequestLogging;
 exports.readClientHeaders = readClientHeaders;
 exports.formatClientError = formatClientError;
 exports.buildClientGuard = buildClientGuard;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_stream_1 = require("node:stream");
 const index_1 = require("../index");
+const logging_1 = require("./logging");
+function normalizeLogContextValue(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    const normalized = `${value}`.trim();
+    return normalized.length > 0 ? normalized : undefined;
+}
+function setRequestLogContext(request, input) {
+    const nextUserId = normalizeLogContextValue(input.userId);
+    const nextRoomId = normalizeLogContextValue(input.roomId);
+    const current = request.requestLogContext ?? {};
+    request.requestLogContext = {
+        ...(current.userId ? { userId: current.userId } : {}),
+        ...(current.roomId ? { roomId: current.roomId } : {}),
+        ...(nextUserId ? { userId: nextUserId } : {}),
+        ...(nextRoomId ? { roomId: nextRoomId } : {}),
+    };
+}
+function createStructuredLogMirrorStream(logFilePath) {
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(logFilePath), { recursive: true });
+    const fileStream = node_fs_1.default.createWriteStream(logFilePath, { flags: 'a' });
+    return new node_stream_1.Writable({
+        write(chunk, _encoding, callback) {
+            process.stdout.write(chunk);
+            fileStream.write(chunk, callback);
+        },
+        final(callback) {
+            fileStream.end(callback);
+        },
+    });
+}
+function buildFastifyLogger(service) {
+    const logger = {
+        level: process.env['LOG_LEVEL']?.trim() || 'info',
+        base: (0, index_1.resolveStructuredLogFields)(service),
+        messageKey: 'message',
+        formatters: {
+            level(label) {
+                return { level: label };
+            },
+        },
+        timestamp: () => `,"timestamp":"${new Date().toISOString()}"`,
+    };
+    const logFilePath = (0, logging_1.resolveStructuredLogFilePath)(service);
+    if (!logFilePath) {
+        return logger;
+    }
+    return {
+        ...logger,
+        stream: createStructuredLogMirrorStream(logFilePath),
+    };
+}
+function buildFastifyServerOptions(params) {
+    return {
+        logger: buildFastifyLogger(params.service),
+        disableRequestLogging: true,
+        requestIdHeader: 'x-request-id',
+        genReqId(request) {
+            const explicit = request.headers['x-request-id'];
+            if (typeof explicit === 'string' && explicit.trim().length > 0) {
+                return explicit.trim();
+            }
+            if (Array.isArray(explicit) && typeof explicit[0] === 'string' && explicit[0].trim().length > 0) {
+                return explicit[0].trim();
+            }
+            return (0, node_crypto_1.randomUUID)();
+        },
+        ...(typeof params.bodyLimit === 'number' ? { bodyLimit: params.bodyLimit } : {}),
+    };
+}
+function registerStructuredRequestLogging(app) {
+    app.addHook('onRequest', async (request, reply) => {
+        reply.header('x-request-id', request.id);
+        request.log.info({
+            request_id: request.id,
+            method: request.method,
+            path: request.url,
+            host: request.hostname,
+            remote_ip: request.ip,
+        }, 'request_started');
+    });
+    app.addHook('onError', async (request, _reply, error) => {
+        const context = request.requestLogContext ?? {};
+        request.log.error({
+            err: error,
+            request_id: request.id,
+            method: request.method,
+            path: request.url,
+            user_id: context.userId,
+            room_id: context.roomId,
+        }, 'request_failed');
+    });
+    app.addHook('onResponse', async (request, reply) => {
+        const context = request.requestLogContext ?? {};
+        const elapsedMs = typeof reply.elapsedTime === 'number' ? Math.round(reply.elapsedTime) : undefined;
+        request.log.info({
+            request_id: request.id,
+            method: request.method,
+            path: request.url,
+            route: request.routeOptions.url,
+            status_code: reply.statusCode,
+            duration_ms: elapsedMs,
+            user_id: context.userId,
+            room_id: context.roomId,
+        }, 'request_completed');
+    });
+}
 function readClientHeaders(request) {
     const headers = request.headers || {};
     const getHeader = (name) => {

package/node_modules/@playdrop/config/dist/src/server/logging.d.ts

@@ -0,0 +1,3 @@
+export declare function resolveStructuredLogFilePath(service: string, env?: NodeJS.ProcessEnv): string | null;
+export declare function createStructuredLogEmitter(service: string, env?: NodeJS.ProcessEnv): (payload: Record<string, unknown>, stream?: 'stdout' | 'stderr') => void;
+//# sourceMappingURL=logging.d.ts.map

package/node_modules/@playdrop/config/dist/src/server/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/server/logging.ts"],"names":[],"mappings":"AAYA,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,IAAI,CAMf;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAqB1E"}

package/node_modules/@playdrop/config/dist/src/server/logging.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveStructuredLogFilePath = resolveStructuredLogFilePath;
+exports.createStructuredLogEmitter = createStructuredLogEmitter;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function normalizeStructuredLogDir(env = process.env) {
+    const value = env['PLAYDROP_STRUCTURED_LOG_DIR'];
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : null;
+}
+function resolveStructuredLogFilePath(service, env = process.env) {
+    const directory = normalizeStructuredLogDir(env);
+    if (!directory) {
+        return null;
+    }
+    return path_1.default.join(directory, `${service}.jsonl`);
+}
+function createStructuredLogEmitter(service, env = process.env) {
+    const logFilePath = resolveStructuredLogFilePath(service, env);
+    const fileStream = logFilePath
+        ? fs_1.default.createWriteStream(logFilePath, { flags: 'a' })
+        : null;
+    return (payload, stream = 'stdout') => {
+        const normalizedPayload = Object.prototype.hasOwnProperty.call(payload, 'timestamp')
+            ? payload
+            : {
+                timestamp: new Date().toISOString(),
+                ...payload,
+            };
+        const line = `${JSON.stringify(normalizedPayload)}\n`;
+        if (stream === 'stderr') {
+            process.stderr.write(line);
+        }
+        else {
+            process.stdout.write(line);
+        }
+        fileStream?.write(line);
+    };
+}

package/node_modules/@playdrop/config/dist/test/deployment.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deployment.test.d.ts.map

package/node_modules/@playdrop/config/dist/test/deployment.test.d.ts.map

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

package/node_modules/@playdrop/config/dist/test/deployment.test.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = __importDefault(require("node:test"));
+const deployment_1 = require("../src/deployment");
+(0, node_test_1.default)('deploy role parsing stays strict', () => {
+    strict_1.default.equal((0, deployment_1.parseDeployRole)('prod'), 'prod');
+    strict_1.default.equal((0, deployment_1.parseDeployRole)('preview'), 'preview');
+    strict_1.default.equal((0, deployment_1.parseDeployRole)('blue'), null);
+    strict_1.default.equal((0, deployment_1.parseDeployRole)(undefined), null);
+});
+(0, node_test_1.default)('deploy slot parsing stays strict', () => {
+    strict_1.default.equal((0, deployment_1.parseDeploySlot)('blue'), 'blue');
+    strict_1.default.equal((0, deployment_1.parseDeploySlot)('green'), 'green');
+    strict_1.default.equal((0, deployment_1.parseDeploySlot)('prod'), null);
+});
+(0, node_test_1.default)('prod defaults resolve to public production origins', () => {
+    const env = { NODE_ENV: 'production' };
+    strict_1.default.equal((0, deployment_1.resolveDeployRole)(env), 'prod');
+    strict_1.default.equal((0, deployment_1.resolvePublicSurface)(env), 'prod');
+    strict_1.default.equal((0, deployment_1.resolveWebOrigin)(env), 'https://www.playdrop.ai');
+    strict_1.default.equal((0, deployment_1.resolveApiOrigin)(env), 'https://api.playdrop.ai');
+    strict_1.default.equal((0, deployment_1.resolveAiOrigin)(env), 'https://ai.playdrop.ai');
+    strict_1.default.equal((0, deployment_1.resolveRealtimeOrigin)(env), 'wss://play.playdrop.ai');
+    strict_1.default.equal((0, deployment_1.resolveSeoIndexingMode)(env), 'public');
+    strict_1.default.equal((0, deployment_1.isBackgroundWorkEnabled)(env), true);
+});
+(0, node_test_1.default)('preview defaults resolve to preview origins and noindex seo', () => {
+    const env = {
+        NODE_ENV: 'production',
+        PLAYDROP_DEPLOY_ROLE: 'preview',
+        PLAYDROP_SLOT: 'green',
+    };
+    strict_1.default.equal((0, deployment_1.resolveDeployRole)(env), 'preview');
+    strict_1.default.equal((0, deployment_1.resolvePublicSurface)(env), 'preview');
+    strict_1.default.equal((0, deployment_1.resolveWebOrigin)(env), 'https://preview.playdrop.ai');
+    strict_1.default.equal((0, deployment_1.resolveApiOrigin)(env), 'https://api.preview.playdrop.ai');
+    strict_1.default.equal((0, deployment_1.resolveAiOrigin)(env), 'https://ai.preview.playdrop.ai');
+    strict_1.default.equal((0, deployment_1.resolveRealtimeOrigin)(env), 'wss://play.preview.playdrop.ai');
+    strict_1.default.equal((0, deployment_1.resolveSeoIndexingMode)(env), 'noindex');
+    strict_1.default.equal((0, deployment_1.isBackgroundWorkEnabled)(env), false);
+});
+(0, node_test_1.default)('explicit origin overrides win over derived defaults', () => {
+    const env = {
+        PLAYDROP_PUBLIC_ORIGIN: 'https://blue.playdrop.ai/',
+        PLAYDROP_API_BASE_URL: 'https://api.blue.playdrop.ai/',
+        PLAYDROP_AI_BASE_URL: 'https://ai.blue.playdrop.ai/',
+        PLAYDROP_REALTIME_BASE_URL: 'wss://play.blue.playdrop.ai/ws/',
+        PLAYDROP_PUBLIC_SURFACE: 'blue',
+    };
+    strict_1.default.equal((0, deployment_1.resolvePublicSurface)(env), 'blue');
+    strict_1.default.equal((0, deployment_1.resolveWebOrigin)(env), 'https://blue.playdrop.ai');
+    strict_1.default.equal((0, deployment_1.resolveApiOrigin)(env), 'https://api.blue.playdrop.ai');
+    strict_1.default.equal((0, deployment_1.resolveAiOrigin)(env), 'https://ai.blue.playdrop.ai');
+    strict_1.default.equal((0, deployment_1.resolveRealtimeOrigin)(env), 'wss://play.blue.playdrop.ai/ws');
+});
+(0, node_test_1.default)('structured log fields include phase 1 deploy metadata', () => {
+    const fields = (0, deployment_1.resolveStructuredLogFields)('api-server', {
+        NODE_ENV: 'production',
+        PLAYDROP_DEPLOY_ROLE: 'preview',
+        PLAYDROP_SLOT: 'green',
+        PLAYDROP_PUBLIC_SURFACE: 'preview',
+    });
+    strict_1.default.equal(fields.environment, 'production');
+    strict_1.default.equal(fields.slot, 'green');
+    strict_1.default.equal(fields.service, 'api-server');
+    strict_1.default.equal(fields.deploy_role, 'preview');
+    strict_1.default.equal(fields.public_surface, 'preview');
+    strict_1.default.match(fields.release_version, /^\d+\.\d+\.\d+$/);
+    strict_1.default.equal(typeof fields.build_number, 'number');
+});

package/node_modules/@playdrop/config/dist/test/logging.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logging.test.d.ts.map

package/node_modules/@playdrop/config/dist/test/logging.test.d.ts.map

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

package/node_modules/@playdrop/config/dist/test/logging.test.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = __importDefault(require("node:test"));
+const logging_1 = require("../src/server/logging");
+(0, node_test_1.default)('structured log file path is disabled without an explicit directory', () => {
+    strict_1.default.equal((0, logging_1.resolveStructuredLogFilePath)('api-server', {}), null);
+});
+(0, node_test_1.default)('structured log file path resolves to a per-service jsonl file', () => {
+    const filePath = (0, logging_1.resolveStructuredLogFilePath)('api-server', {
+        PLAYDROP_STRUCTURED_LOG_DIR: '/var/log/playdrop',
+    });
+    strict_1.default.equal(filePath, '/var/log/playdrop/api-server.jsonl');
+});