n8n-nodes-shortgenius 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ShortGenius
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# n8n-nodes-shortgenius
+
+n8n community node for [ShortGenius](https://shortgenius.com) — generate AI videos, images, and audio, and manage your ShortGenius account.
+
+## Install
+
+In your n8n instance:
+
+```
+npm install n8n-nodes-shortgenius
+```
+
+Restart n8n. The package ships two nodes (`ShortGenius` and `ShortGenius Trigger`) and one credential type (`ShortGenius API`).
+
+## Authentication
+
+1. Sign in to ShortGenius and open **Developers → API keys** at https://shortgenius.com/developers/keys to create an API key (it starts with `sg-`).
+2. In n8n, **Credentials → New → ShortGenius API** and paste the key, then hit **Test**. The default base URL (`https://api.shortgenius.com/v1`) is correct for production.
+3. ShortGenius is single-user — the API key alone authenticates. There is no organization to configure. The connection test calls `GET /credits`.
+
+## Nodes
+
+### ShortGenius (action)
+
+| Resource | Operations |
+|---|---|
+| Video | List, Get, Create, Draft, Draft From URL, Draft From Script, Draft Quiz, Draft News, Generate Topics |
+| Series | List, Get, Create |
+| Image | List, Get, Create, List Styles |
+| Audio | List, Get, Create Speech |
+| Voice | List, Get |
+| Music | List Genres, List Tracks |
+| Connection | List |
+| Credits | Get Balance |
+| Webhook | List Endpoints, Create Endpoint, Delete Endpoint |
+
+Videos are drafted first (write/review a script), then created (rendered). Created videos, generated images, and synthesized audio render asynchronously — poll the corresponding **Get** operation until the state is `completed`, or use the **ShortGenius Trigger** node to react to completion webhooks.
+
+### ShortGenius Trigger
+
+Subscribes to ShortGenius lifecycle events and emits a workflow run per delivery, with the event's inner `data` payload as the item JSON. Supported events:
+
+- `video.created`
+- `video.completed`
+- `video.published`
+- `series.created`
+- `image.completed`
+- `audio.completed`
+- `*` (all events)
+
+Activating the trigger registers a webhook endpoint at ShortGenius pointing at the n8n production URL. Deactivating it deletes the endpoint so you do not leak orphan subscriptions. Every delivery is verified per-request (HMAC-SHA256 over `<timestamp>.<rawBody>`, 5-minute timestamp window) using the `ShortGenius-Signature` header.
+
+## Use as an AI Agent tool
+
+The ShortGenius node is marked `usableAsTool`, so an n8n **AI Agent** can call it directly: add the AI Agent node, click the **Tool** connector, and pick **ShortGenius**. The agent can then draft and render videos, generate images, synthesize speech, and more from natural-language instructions.
+
+Self-hosted instances must allow community nodes as tools by setting the environment variable `N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true`.
+
+## Links
+
+- Integrations landing page: https://shortgenius.com/integrations/n8n
+- API docs: https://shortgenius.com/developers
+- Source: https://github.com/ShortGenius/shorts/tree/main/packages/n8n-node
+
+## License
+
+MIT.

package/dist/credentials/ShortGeniusApi.credentials.d.ts

@@ -0,0 +1,20 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+/**
+ * Credential type for the ShortGenius n8n nodes.
+ *
+ * Stores a ShortGenius API key generated at
+ * https://shortgenius.com/developers/keys. The key (starts with `sg-`) is sent
+ * on every request as `Authorization: Bearer <key>`.
+ *
+ * ShortGenius is single-user — the API key alone authenticates, so there is no
+ * organization concept. The credential test hits GET /credits, which 200s for a
+ * valid key and 401s for a bad one.
+ */
+export declare class ShortGeniusApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/ShortGeniusApi.credentials.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShortGeniusApi = void 0;
+/**
+ * Credential type for the ShortGenius n8n nodes.
+ *
+ * Stores a ShortGenius API key generated at
+ * https://shortgenius.com/developers/keys. The key (starts with `sg-`) is sent
+ * on every request as `Authorization: Bearer <key>`.
+ *
+ * ShortGenius is single-user — the API key alone authenticates, so there is no
+ * organization concept. The credential test hits GET /credits, which 200s for a
+ * valid key and 401s for a bad one.
+ */
+class ShortGeniusApi {
+    name = 'shortGeniusApi';
+    displayName = 'ShortGenius API';
+    documentationUrl = 'https://shortgenius.com/developers';
+    properties = [
+        {
+            displayName: 'API Key',
+            name: 'apiKey',
+            type: 'string',
+            typeOptions: { password: true },
+            default: '',
+            required: true,
+            description: 'Generate one at ShortGenius → Developers → API keys. Starts with sg-.'
+        },
+        {
+            displayName: 'Base URL',
+            name: 'baseUrl',
+            type: 'string',
+            default: 'https://api.shortgenius.com/v1',
+            description: 'Override only if you are pointing at a non-production deployment.'
+        }
+    ];
+    // Sends the key as `Authorization: Bearer <key>` on credential-test and any
+    // declarative request that uses this credential.
+    authenticate = {
+        type: 'generic',
+        properties: {
+            headers: {
+                Authorization: '=Bearer {{$credentials.apiKey}}'
+            }
+        }
+    };
+    // Powers the "Test" button: a lightweight GET /credits that 200s for a valid
+    // key and 401s for a bad one.
+    test = {
+        request: {
+            baseURL: '={{$credentials.baseUrl}}',
+            url: '/credits'
+        }
+    };
+}
+exports.ShortGeniusApi = ShortGeniusApi;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { ShortGeniusApi } from './credentials/ShortGeniusApi.credentials';
+export { ShortGenius } from './nodes/ShortGenius/ShortGenius.node';
+export { ShortGeniusTrigger } from './nodes/ShortGeniusTrigger/ShortGeniusTrigger.node';

package/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+// Re-exports so consumers (and the n8n loader) can import the node and
+// credential classes without reaching into the dist tree directly. The
+// actual `n8n` package.json field still points at compiled dist/*.js so
+// runtime discovery does not depend on this file.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShortGeniusTrigger = exports.ShortGenius = exports.ShortGeniusApi = void 0;
+var ShortGeniusApi_credentials_1 = require("./credentials/ShortGeniusApi.credentials");
+Object.defineProperty(exports, "ShortGeniusApi", { enumerable: true, get: function () { return ShortGeniusApi_credentials_1.ShortGeniusApi; } });
+var ShortGenius_node_1 = require("./nodes/ShortGenius/ShortGenius.node");
+Object.defineProperty(exports, "ShortGenius", { enumerable: true, get: function () { return ShortGenius_node_1.ShortGenius; } });
+var ShortGeniusTrigger_node_1 = require("./nodes/ShortGeniusTrigger/ShortGeniusTrigger.node");
+Object.defineProperty(exports, "ShortGeniusTrigger", { enumerable: true, get: function () { return ShortGeniusTrigger_node_1.ShortGeniusTrigger; } });

package/dist/nodes/ShortGenius/ShortGenius.node.d.ts

@@ -0,0 +1,15 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+/**
+ * Action node for the ShortGenius API.
+ *
+ * Mirrors the @shortgenius/sdk surface: Videos, Series, Images, Audio, Voices,
+ * Music, Connections, Credits, Webhooks. Each operation maps directly to a
+ * method on the SDK client so the shape stays in sync when new endpoints land.
+ *
+ * ShortGenius is single-user — the API key authenticates and there is NO
+ * organization parameter anywhere.
+ */
+export declare class ShortGenius implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}