primcli 1.17.0 → 1.18.0

package/dist/oclif/index.js

@@ -22242,6 +22242,31 @@ const operationManifest = [
 	}
 ];
 //#endregion
+//#region ../packages/api-core/src/memories.ts
+function isPlainJsonObject(value) {
+	const prototype = Object.getPrototypeOf(value);
+	return prototype === Object.prototype || prototype === null;
+}
+function isMemoryJsonValue(value, seen = /* @__PURE__ */ new Set()) {
+	if (value === null) return true;
+	if (typeof value === "string" || typeof value === "boolean") return true;
+	if (typeof value === "number") return Number.isFinite(value);
+	if (typeof value !== "object") return false;
+	if (seen.has(value)) return false;
+	seen.add(value);
+	try {
+		if (Array.isArray(value)) {
+			for (let index = 0; index < value.length; index += 1) if (!(index in value) || !isMemoryJsonValue(value[index], seen)) return false;
+			return true;
+		}
+		if (!isPlainJsonObject(value)) return false;
+		for (const nested of Object.values(value)) if (!isMemoryJsonValue(nested, seen)) return false;
+		return true;
+	} finally {
+		seen.delete(value);
+	}
+}
+//#endregion
 //#region src/oclif/api-client.ts
 const API_HEADERS_ENV = "PRIMITIVE_API_HEADERS";
 const OAUTH_REFRESH_SKEW_MS = 60 * 1e3;
@@ -26542,8 +26567,8 @@ const PRIMITIVE_TEAM_AUTHOR = {
 	name: "Primitive Team",
 	url: "https://primitive.dev"
 };
-const SDK_VERSION_RANGE = "^1.17.0";
-const CLI_VERSION_RANGE = "^1.17.0";
+const SDK_VERSION_RANGE = "^1.18.0";
+const CLI_VERSION_RANGE = "^1.18.0";
 const ESBUILD_VERSION_RANGE = "^0.27.0";
 function renderHandler() {
 	return `// env.PRIMITIVE_API_KEY, env.PRIMITIVE_WEBHOOK_SECRET, and
@@ -29689,6 +29714,7 @@ var LogoutCommand = class LogoutCommand extends Command {
 };
 //#endregion
 //#region src/oclif/commands/memories.ts
+var MemoryCliInputError = class extends Error {};
 const API_KEY_FLAG = Flags.string({
 	description: "Primitive API key override (defaults to PRIMITIVE_API_KEY or saved OAuth login credentials)",
 	env: "PRIMITIVE_API_KEY"
@@ -29721,11 +29747,27 @@ function printData(command, responseData) {
 	const data = responseData?.data ?? null;
 	command.log(JSON.stringify(data, null, 2));
 }
+function handleMemoryInputError(error) {
+	if (!(error instanceof MemoryCliInputError)) return false;
+	process.stderr.write(`${error.message}\n`);
+	process.exitCode = 1;
+	return true;
+}
+function nonEmptyFlag(value, name) {
+	if (value === void 0) return void 0;
+	if (value.trim().length === 0) throw new MemoryCliInputError(`${name} must be a non-empty string.`);
+	return value;
+}
 function parseMemoryJson(source, label = "value") {
 	try {
+		const value = JSON.parse(source);
+		if (!isMemoryJsonValue(value)) return {
+			kind: "error",
+			message: `${label} must be valid JSON. Numbers must be finite, arrays must not be sparse, and values may not contain undefined, bigint, symbol, function, class instance, or cyclic entries.`
+		};
 		return {
 			kind: "ok",
-			value: JSON.parse(source)
+			value
 		};
 	} catch (error) {
 		return {
@@ -29762,31 +29804,63 @@ function resolveMemoryValueSource(input) {
 	};
 }
 function memoryScopeForBody(flags) {
-	if (flags.function) return {
+	const functionId = nonEmptyFlag(flags.function, "--function");
+	if (functionId !== void 0) return {
 		type: "function",
-		id: flags.function
+		id: functionId
 	};
 	if (flags.org) return { type: "org" };
 }
 function memoryScopeForQuery(flags) {
-	if (flags.function) return {
+	const functionId = nonEmptyFlag(flags.function, "--function");
+	if (functionId !== void 0) return {
 		scope_type: "function",
-		scope_id: flags.function
+		scope_id: functionId
 	};
 	if (flags.org) return { scope_type: "org" };
 	return {};
 }
 function buildSetMemoryInput(params) {
 	const scope = memoryScopeForBody(params.flags);
+	const expiresAt = nonEmptyFlag(params.flags["expires-at"], "--expires-at");
+	const ifVersion = nonEmptyFlag(params.flags["if-version"], "--if-version");
 	return {
 		key: params.key,
 		value: params.value,
 		...scope ? { scope } : {},
 		...params.flags["ttl-seconds"] !== void 0 ? { ttl_seconds: params.flags["ttl-seconds"] } : {},
-		...params.flags["expires-at"] ? { expires_at: params.flags["expires-at"] } : {},
+		...expiresAt !== void 0 ? { expires_at: expiresAt } : {},
 		...params.flags["clear-ttl"] ? { clear_ttl: true } : {},
 		...params.flags["if-absent"] ? { if_absent: true } : {},
-		...params.flags["if-version"] ? { if_version: params.flags["if-version"] } : {}
+		...ifVersion !== void 0 ? { if_version: ifVersion } : {}
+	};
+}
+function buildGetMemoryQuery(params) {
+	return {
+		key: params.key,
+		...memoryScopeForQuery(params.flags)
+	};
+}
+function buildDeleteMemoryQuery(params) {
+	const ifVersion = nonEmptyFlag(params.flags["if-version"], "--if-version");
+	return {
+		key: params.key,
+		...memoryScopeForQuery(params.flags),
+		...ifVersion !== void 0 ? { if_version: ifVersion } : {}
+	};
+}
+function buildSearchMemoriesQuery(params) {
+	const cursor = nonEmptyFlag(params.flags.cursor, "--cursor");
+	const updatedAfter = nonEmptyFlag(params.flags["updated-after"], "--updated-after");
+	const updatedBefore = nonEmptyFlag(params.flags["updated-before"], "--updated-before");
+	return {
+		...params.prefix !== void 0 ? { prefix: params.prefix } : {},
+		limit: params.flags.limit,
+		...cursor !== void 0 ? { cursor } : {},
+		...params.flags["metadata-only"] ? { include_value: "false" } : {},
+		...updatedAfter !== void 0 ? { updated_after: updatedAfter } : {},
+		...updatedBefore !== void 0 ? { updated_before: updatedBefore } : {},
+		...memoryScopeForQuery(params.flags)
 	};
 }
 var MemoriesSetCommand = class MemoriesSetCommand extends Command {
@@ -29857,6 +29931,17 @@ var MemoriesSetCommand = class MemoriesSetCommand extends Command {
 			process.exitCode = 1;
 			return;
 		}
+		let body;
+		try {
+			body = buildSetMemoryInput({
+				key: args.key,
+				value: parsed.value,
+				flags
+			});
+		} catch (error) {
+			if (handleMemoryInputError(error)) return;
+			throw error;
+		}
 		const { apiClient, auth, baseUrlOverridden } = await createAuthenticatedCliApiClient({
 			apiKey: flags["api-key"],
 			apiBaseUrl: flags["api-base-url"],
@@ -29865,11 +29950,7 @@ var MemoriesSetCommand = class MemoriesSetCommand extends Command {
 		await runWithTiming(flags.time, async () => {
 			const result = await setMemory({
 				client: apiClient.client,
-				body: buildSetMemoryInput({
-					key: args.key,
-					value: parsed.value,
-					flags
-				}),
+				body,
 				responseStyle: "fields"
 			});
 			if (result.error) {
@@ -29903,6 +29984,16 @@ var MemoriesGetCommand = class MemoriesGetCommand extends Command {
 	};
 	async run() {
 		const { args, flags } = await this.parse(MemoriesGetCommand);
+		let query;
+		try {
+			query = buildGetMemoryQuery({
+				key: args.key,
+				flags
+			});
+		} catch (error) {
+			if (handleMemoryInputError(error)) return;
+			throw error;
+		}
 		const { apiClient, auth, baseUrlOverridden } = await createAuthenticatedCliApiClient({
 			apiKey: flags["api-key"],
 			apiBaseUrl: flags["api-base-url"],
@@ -29911,10 +30002,7 @@ var MemoriesGetCommand = class MemoriesGetCommand extends Command {
 		await runWithTiming(flags.time, async () => {
 			const result = await getMemory({
 				client: apiClient.client,
-				query: {
-					key: args.key,
-					...memoryScopeForQuery(flags)
-				},
+				query,
 				responseStyle: "fields"
 			});
 			if (result.error) {
@@ -29950,6 +30038,16 @@ var MemoriesDeleteCommand = class MemoriesDeleteCommand extends Command {
 	};
 	async run() {
 		const { args, flags } = await this.parse(MemoriesDeleteCommand);
+		let query;
+		try {
+			query = buildDeleteMemoryQuery({
+				key: args.key,
+				flags
+			});
+		} catch (error) {
+			if (handleMemoryInputError(error)) return;
+			throw error;
+		}
 		const { apiClient, auth, baseUrlOverridden } = await createAuthenticatedCliApiClient({
 			apiKey: flags["api-key"],
 			apiBaseUrl: flags["api-base-url"],
@@ -29958,11 +30056,7 @@ var MemoriesDeleteCommand = class MemoriesDeleteCommand extends Command {
 		await runWithTiming(flags.time, async () => {
 			const result = await deleteMemory({
 				client: apiClient.client,
-				query: {
-					key: args.key,
-					...memoryScopeForQuery(flags),
-					...flags["if-version"] ? { if_version: flags["if-version"] } : {}
-				},
+				query,
 				responseStyle: "fields"
 			});
 			if (result.error) {
@@ -30007,6 +30101,16 @@ var MemoriesSearchCommand = class MemoriesSearchCommand extends Command {
 	};
 	async run() {
 		const { args, flags } = await this.parse(MemoriesSearchCommand);
+		let query;
+		try {
+			query = buildSearchMemoriesQuery({
+				prefix: args.prefix,
+				flags
+			});
+		} catch (error) {
+			if (handleMemoryInputError(error)) return;
+			throw error;
+		}
 		const { apiClient, auth, baseUrlOverridden } = await createAuthenticatedCliApiClient({
 			apiKey: flags["api-key"],
 			apiBaseUrl: flags["api-base-url"],
@@ -30015,15 +30119,7 @@ var MemoriesSearchCommand = class MemoriesSearchCommand extends Command {
 		await runWithTiming(flags.time, async () => {
 			const result = await searchMemories({
 				client: apiClient.client,
-				query: {
-					...args.prefix !== void 0 ? { prefix: args.prefix } : {},
-					limit: flags.limit,
-					...flags.cursor ? { cursor: flags.cursor } : {},
-					...flags["metadata-only"] ? { include_value: "false" } : {},
-					...flags["updated-after"] ? { updated_after: flags["updated-after"] } : {},
-					...flags["updated-before"] ? { updated_before: flags["updated-before"] } : {},
-					...memoryScopeForQuery(flags)
-				},
+				query,
 				responseStyle: "fields"
 			});
 			if (result.error) {

package/man/primitive.1

@@ -77,6 +77,15 @@ Scaffold a Primitive Function.
 .B primitive functions deploy --name NAME --file PATH
 Deploy a Primitive Function bundle.
 .TP
+.B primitive memories set KEY JSON
+Store a durable JSON memory.
+.TP
+.B primitive memories get KEY
+Read a durable memory by key.
+.TP
+.B primitive memories search PREFIX
+List memories by key prefix.
+.TP
 .B primitive list-operations
 Print the generated API operation manifest.
 .TP

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primcli",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "Official Primitive CLI: deploy Primitive Functions, send and inspect mail, manage endpoints, all from the terminal. Wraps the @primitivedotdev/sdk runtime client with one-shot commands.",
   "type": "module",
   "sideEffects": false,