photon-msg 0.0.0-stage → 0.1.0

package/dist/commands/spaces.js

@@ -0,0 +1,118 @@
+/**
+ * `spaces` — conversations. `create` is idempotent: it reuses an exact match.
+ */
+import { handleOf, nextPageToken, pageItems } from "../client.js";
+import { formatTime } from "../output.js";
+import { usageError } from "../errors.js";
+import { resolveUser } from "../target.js";
+export const list = {
+    options: {
+        platform: { type: "string" },
+        participant: { type: "string" },
+        "participant-handle": { type: "string" },
+        order: { type: "string" },
+        "order-by": { type: "string" },
+        "created-since": { type: "string" },
+        "created-before": { type: "string" },
+        "page-size": { type: "string" },
+        "page-token": { type: "string" },
+    },
+    async run({ client, projectId, flags, out }) {
+        const query = {};
+        if (flags.platform)
+            query.platform = flags.platform;
+        if (typeof flags.participant === "string")
+            query.participantId = flags.participant;
+        if (flags["participant-handle"])
+            query.participantHandle = flags["participant-handle"];
+        if (flags.order)
+            query.order = flags.order;
+        if (flags["order-by"])
+            query.orderBy = flags["order-by"];
+        if (flags["created-since"])
+            query.createdSince = flags["created-since"];
+        if (flags["created-before"])
+            query.createdBefore = flags["created-before"];
+        if (flags["page-size"])
+            query.pageSize = Number(flags["page-size"]);
+        if (flags["page-token"])
+            query.pageToken = flags["page-token"];
+        const page = await client.projects.listSpaces({ path: { id: projectId }, query });
+        const items = pageItems(page);
+        const columns = [
+            { header: "ID", value: (space) => space.id },
+            { header: "PLATFORM", value: (space) => space.platform },
+            { header: "KIND", value: (space) => space.kind },
+            { header: "NAME", value: (space) => space.title ?? space.name ?? "" },
+            { header: "CREATED", value: (space) => formatTime(space.createdAt) },
+        ];
+        out.data({ items, count: items.length, nextPageToken: nextPageToken(page) ?? null });
+        out.table(items, columns);
+        if (!flags.quiet)
+            out.info(`${items.length} space(s)`);
+    },
+};
+export const get = {
+    options: {},
+    async run({ client, projectId, positionals, out }) {
+        const spaceId = positionals[0];
+        if (!spaceId)
+            throw usageError("Usage: photon-msg spaces get <spaceId>");
+        const space = (await client.projects.getSpace({
+            path: { id: projectId, spaceId },
+        }));
+        out.data(space);
+        out.heading(`space ${space.id}`);
+        out.keyValue([
+            ["platform", space.platform],
+            ["kind", space.kind],
+            ["title", space.title ?? space.name ?? ""],
+            ["created", formatTime(space.createdAt)],
+        ]);
+    },
+};
+export const create = {
+    options: {
+        platform: { type: "string" },
+        participant: { type: "string", multiple: true },
+        "idempotency-key": { type: "string" },
+    },
+    async run({ client, projectId, flags, out, dryRun }) {
+        const platform = flags.platform ?? "imessage";
+        const inputs = Array.isArray(flags.participant)
+            ? flags.participant
+            : flags.participant
+                ? [flags.participant]
+                : [];
+        if (inputs.length < 1) {
+            throw usageError("Pass at least one --participant <handle|userId>.");
+        }
+        if (dryRun) {
+            out.data({ dryRun: true, platform, participants: inputs });
+            out.line(`would create a ${platform} space with ${inputs.length} participant(s)`);
+            return;
+        }
+        const resolved = await Promise.all(inputs.map((input) => resolveUser({ client, projectId, platform, input })));
+        const participantIds = resolved.map((user) => String(user.id));
+        const space = (await client.projects.createOrGetSpace({
+            path: { id: projectId },
+            headers: {
+                "idempotency-key": flags["idempotency-key"] ?? `photon-msg:space:${participantIds.join(":")}`,
+            },
+            body: { platform, participantIds },
+        }));
+        out.data({
+            spaceId: space.id,
+            kind: space.kind,
+            platform: space.platform,
+            participants: resolved.map((user) => ({
+                id: user.id,
+                handle: handleOf(user),
+                kind: user.kind,
+            })),
+        });
+        if (!flags.quiet)
+            out.success(`space ${space.id} (${space.kind ?? "?"})`);
+    },
+};
+//# sourceMappingURL=spaces.js.map

package/dist/commands/spaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaces.js","sourceRoot":"","sources":["../../src/commands/spaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,OAAO,EAAE;QACP,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACnC,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACpC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACS;IAE3C,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAkB;QACzD,MAAM,KAAK,GAAoC,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,QAAQ;YAAE,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACpD,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;YAAE,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,WAAW,CAAC;QACnF,IAAI,KAAK,CAAC,oBAAoB,CAAC;YAAE,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACvF,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC3C,IAAI,KAAK,CAAC,UAAU,CAAC;YAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,eAAe,CAAC;YAAE,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;QACxE,IAAI,KAAK,CAAC,gBAAgB,CAAC;YAAE,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC3E,IAAI,KAAK,CAAC,WAAW,CAAC;YAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QACpE,IAAI,KAAK,CAAC,YAAY,CAAC;YAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;QAE/D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAClF,MAAM,KAAK,GAAG,SAAS,CAAc,IAAI,CAAC,CAAC;QAE3C,MAAM,OAAO,GAAoC;YAC/C,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE;YAC5C,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE;YACxD,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;YAChD,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE;YACrE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;SACrE,CAAC;QAEF,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACrF,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,WAAW,CAAC,CAAC;IACzD,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,OAAO,EAAE,EAA4C;IAErD,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,EAAkB;QAC/D,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,OAAO;YAAE,MAAM,UAAU,CAAC,wCAAwC,CAAC,CAAC;QAEzE,MAAM,KAAK,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC5C,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;SACjC,CAAC,CAA2B,CAAC;QAE9B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACjC,GAAG,CAAC,QAAQ,CAAC;YACX,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC;YAC5B,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;YACpB,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAC1C,CAAC,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE;QACP,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/C,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACI;IAE3C,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAkB;QACjE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,UAAU,CAAC;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;YAC7C,CAAC,CAAC,KAAK,CAAC,WAAW;YACnB,CAAC,CAAC,KAAK,CAAC,WAAW;gBACjB,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;gBACrB,CAAC,CAAC,EAAE,CAAC;QAET,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,UAAU,CAAC,kDAAkD,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,IAAI,CAAC,kBAAkB,QAAQ,eAAe,MAAM,CAAC,MAAM,iBAAiB,CAAC,CAAC;YAClF,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAC3E,CAAC;QACF,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAE/D,MAAM,KAAK,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACpD,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;YACvB,OAAO,EAAE;gBACP,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI,oBAAoB,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;aAC9F;YACD,IAAI,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE;SACnC,CAAC,CAA2B,CAAC;QAE9B,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACpC,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC;gBACtB,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;SACJ,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC;IAC5E,CAAC;CACF,CAAC"}

package/dist/commands/users.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `users` — the people and agents inside a project.
+ */
+import type { CommandContext } from "../types.js";
+export declare const list: {
+    options: {
+        readonly platform: {
+            readonly type: "string";
+        };
+        readonly "page-size": {
+            readonly type: "string";
+        };
+        readonly "page-token": {
+            readonly type: "string";
+        };
+    };
+    run({ client, projectId, flags, out }: CommandContext): Promise<void>;
+};
+export declare const get: {
+    options: {};
+    run({ client, projectId, positionals, out }: CommandContext): Promise<void>;
+};
+export declare const ensure: {
+    options: {
+        readonly handle: {
+            readonly type: "string";
+        };
+        readonly platform: {
+            readonly type: "string";
+        };
+    };
+    run({ client, projectId, flags, positionals, out, dryRun }: CommandContext): Promise<void>;
+};
+//# sourceMappingURL=users.d.ts.map

package/dist/commands/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/commands/users.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,aAAa,CAAC;AAE9D,eAAO,MAAM,IAAI;;;;;;;;;;;;2CAO8B,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAsB5E,CAAC;AAEF,eAAO,MAAM,GAAG;;iDAGqC,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBlF,CAAC;AAEF,eAAO,MAAM,MAAM;;;;;;;;;gEAMiD,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAqBjG,CAAC"}

package/dist/commands/users.js

@@ -0,0 +1,82 @@
+/**
+ * `users` — the people and agents inside a project.
+ */
+import { handleOf, nextPageToken, pageItems } from "../client.js";
+import { formatTime } from "../output.js";
+import { usageError } from "../errors.js";
+import { normalizeHandle } from "../target.js";
+export const list = {
+    options: {
+        platform: { type: "string" },
+        "page-size": { type: "string" },
+        "page-token": { type: "string" },
+    },
+    async run({ client, projectId, flags, out }) {
+        const query = {};
+        if (flags.platform)
+            query.platform = flags.platform;
+        if (flags["page-size"])
+            query.pageSize = Number(flags["page-size"]);
+        if (flags["page-token"])
+            query.pageToken = flags["page-token"];
+        const page = await client.projects.listUsers({ path: { id: projectId }, query });
+        const items = pageItems(page);
+        const columns = [
+            { header: "ID", value: (user) => user.id },
+            { header: "PLATFORM", value: (user) => user.platform },
+            { header: "KIND", value: (user) => user.kind },
+            { header: "TYPE", value: (user) => user.type ?? "" },
+            { header: "HANDLE", value: (user) => handleOf(user) },
+            { header: "CREATED", value: (user) => formatTime(user.createdAt) },
+        ];
+        out.data({ items, count: items.length, nextPageToken: nextPageToken(page) ?? null });
+        out.table(items, columns);
+        if (!flags.quiet)
+            out.info(`${items.length} user(s)`);
+    },
+};
+export const get = {
+    options: {},
+    async run({ client, projectId, positionals, out }) {
+        const userId = positionals[0];
+        if (!userId)
+            throw usageError("Usage: photon-msg users get <userId>");
+        const user = (await client.projects.getUser({
+            path: { id: projectId, userId },
+        }));
+        out.data(user);
+        out.heading(`user ${user.id}`);
+        out.keyValue([
+            ["platform", user.platform],
+            ["kind", user.kind],
+            ["type", user.type ?? ""],
+            ["handle", handleOf(user)],
+            ["created", formatTime(user.createdAt)],
+        ]);
+    },
+};
+export const ensure = {
+    options: {
+        handle: { type: "string" },
+        platform: { type: "string" },
+    },
+    async run({ client, projectId, flags, positionals, out, dryRun }) {
+        const raw = flags.handle ?? positionals[0];
+        if (!raw)
+            throw usageError("Usage: photon-msg users ensure --handle <handle> [--platform imessage]");
+        const platform = flags.platform ?? (raw.includes("@") ? "email" : "imessage");
+        const handle = normalizeHandle(raw);
+        if (dryRun) {
+            out.data({ dryRun: true, platform, handle });
+            out.line(`would resolve ${handle} on ${platform}`);
+            return;
+        }
+        const user = (await client.projects.createOrGetUser({
+            path: { id: projectId },
+            body: { handle, platform },
+        }));
+        out.data(user);
+        out.success(`${user.id} ${handleOf(user)} (${user.kind}, ${user.platform})`);
+    },
+};
+//# sourceMappingURL=users.js.map

package/dist/commands/users.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Configuration resolution: flags beat environment variables, which beat a
+ * config file. Nothing here reads secrets from the network.
+ */
+import type { Flags } from "./types.js";
+export declare const ENV: {
+    readonly apiKey: "PHOTON_API_KEY";
+    readonly projectId: "PHOTON_PROJECT_ID";
+    readonly baseUrl: "PHOTON_API_BASE_URL";
+    readonly agentHandle: "PHOTON_AGENT_HANDLE";
+};
+export interface Config {
+    apiKey?: string;
+    projectId?: string;
+    baseUrl?: string;
+    agentHandle?: string;
+    timeoutMs?: number;
+}
+/** Config file shape, all fields optional. */
+export interface ConfigFile {
+    apiKey?: string;
+    projectId?: string;
+    baseUrl?: string;
+    agentHandle?: string;
+}
+export declare const defaultConfigPath: () => string;
+/**
+ * Reads the config file when present. A missing file is not an error; malformed
+ * JSON is.
+ */
+export declare function readConfigFile(path?: string): ConfigFile;
+export interface ResolveConfigInput {
+    flags: Flags;
+    env?: NodeJS.ProcessEnv;
+    file?: ConfigFile;
+}
+export declare function resolveConfig({ flags, env, file }: ResolveConfigInput): Config;
+/** A config with the credentials guaranteed present. */
+export interface Credentials extends Config {
+    apiKey: string;
+    projectId: string;
+}
+/** Throws a usage error when credentials are missing. */
+export declare function requireCredentials(config: Config): Credentials;
+/** Redacts a secret for logs and JSON output. */
+export declare const redact: (value: string | undefined) => string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,eAAO,MAAM,GAAG;;;;;CAKN,CAAC;AAEX,MAAM,WAAW,MAAM;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,iBAAiB,QAAO,MACoB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAA4B,GAAG,UAAU,CAa7E;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,GAAiB,EAAE,IAAuB,EAAE,EAAE,kBAAkB,GAAG,MAAM,CA4B/G;AAED,wDAAwD;AACxD,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAW9D;AAED,iDAAiD;AACjD,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,MAC8D,CAAC"}

package/dist/config.js

@@ -0,0 +1,77 @@
+/**
+ * Configuration resolution: flags beat environment variables, which beat a
+ * config file. Nothing here reads secrets from the network.
+ */
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { usageError } from "./errors.js";
+export const ENV = {
+    apiKey: "PHOTON_API_KEY",
+    projectId: "PHOTON_PROJECT_ID",
+    baseUrl: "PHOTON_API_BASE_URL",
+    agentHandle: "PHOTON_AGENT_HANDLE",
+};
+export const defaultConfigPath = () => join(homedir(), ".config", "photon-msg", "config.json");
+/**
+ * Reads the config file when present. A missing file is not an error; malformed
+ * JSON is.
+ */
+export function readConfigFile(path = defaultConfigPath()) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        return typeof parsed === "object" && parsed !== null ? parsed : {};
+    }
+    catch (error) {
+        throw usageError(`Config file ${path} is not valid JSON: ${error.message}`);
+    }
+}
+export function resolveConfig({ flags, env = process.env, file = readConfigFile() }) {
+    const pick = (flagKey, envKey, fileKey) => {
+        const fromFlag = flagKey ? flags[flagKey] : undefined;
+        if (typeof fromFlag === "string" && fromFlag.length > 0)
+            return fromFlag;
+        if (envKey) {
+            const fromEnv = env[envKey];
+            if (typeof fromEnv === "string" && fromEnv.length > 0)
+                return fromEnv;
+        }
+        if (fileKey) {
+            const fromFile = file[fileKey];
+            if (typeof fromFile === "string" && fromFile.length > 0)
+                return fromFile;
+        }
+        return undefined;
+    };
+    const timeout = flags.timeout;
+    return {
+        apiKey: pick("api-key", ENV.apiKey, "apiKey"),
+        projectId: pick("project", ENV.projectId, "projectId"),
+        baseUrl: pick("base-url", ENV.baseUrl, "baseUrl"),
+        // --as is per-command; the default sender comes from env or the config file.
+        agentHandle: pick(undefined, ENV.agentHandle, "agentHandle"),
+        ...(timeout !== undefined && Number.isFinite(Number(timeout)) ? { timeoutMs: Number(timeout) } : {}),
+    };
+}
+/** Throws a usage error when credentials are missing. */
+export function requireCredentials(config) {
+    const missing = [];
+    if (!config.apiKey)
+        missing.push(`an API key (--api-key, ${ENV.apiKey}, or config file)`);
+    if (!config.projectId)
+        missing.push(`a project ID (--project, ${ENV.projectId}, or config file)`);
+    if (missing.length > 0) {
+        throw usageError(`Missing ${missing.join(" and ")}.`, "Create a project key with: photon project api-key create --name cli --permission project:read --permission project:write");
+    }
+    return config;
+}
+/** Redacts a secret for logs and JSON output. */
+export const redact = (value) => typeof value === "string" && value.length > 12 ? `${value.slice(0, 8)}…${value.slice(-4)}` : value ? "***" : "";
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/content.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Turns CLI flags into a Photon `SendContent` payload.
+ *
+ * The API takes one polymorphic `content` object, which is how edits, unsends,
+ * reactions, read receipts, typing indicators and poll votes travel: there is no
+ * separate endpoint per action. This module is the single source of truth for
+ * that mapping, and it stays pure by taking uploads and user lookups as injected
+ * dependencies.
+ */
+import type { SendContent } from "@photon-ai/api";
+import type { BuiltMessage, Flags, Uploader, UserLookup } from "./types.js";
+/** Every content mode the CLI can build. */
+export declare const MODES: readonly ["text", "attachment", "voice", "reaction", "poll", "edit", "delete", "read", "typing", "participants", "group"];
+export type ContentMode = (typeof MODES)[number];
+/** Lists the content modes implied by the given flags. */
+export declare function detectModes(flags: Flags): ContentMode[];
+/** Reads text from a file, or stdin when the path is "-". */
+export declare function readTextFile(path: string): string;
+/**
+ * Cheap, side-effect-free validation of content flags, so the CLI can refuse a
+ * contradictory command before it asks for credentials or touches the network.
+ */
+export declare function validateContentFlags(flags: Flags): ContentMode[];
+export interface BuildMessageInput {
+    flags: Flags;
+    upload: Uploader;
+    getUsers: UserLookup;
+}
+/** Builds the send payload from flags. */
+export declare function buildMessage({ flags, upload, getUsers }: BuildMessageInput): Promise<BuiltMessage>;
+/** Short human description of a payload, used by --dry-run and logs. */
+export declare function describeContent(content: SendContent | undefined): string;
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAEV,WAAW,EAaZ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5E,4CAA4C;AAC5C,eAAO,MAAM,KAAK,2HAYR,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAOjD,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,EAAE,CAmBvD;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjD;AAaD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,EAAE,CAchE;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,0CAA0C;AAC1C,wBAAsB,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6KxG;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CA4BxE"}